Givebutter MCP Server

A Model Context Protocol (MCP) server that provides integration with the Givebutter fundraising platform API. This allows AI assistants like Claude to interact with your Givebutter account to manage campaigns, contacts, transactions, and more.

Features

• Campaigns: List, create, update, and delete fundraising campaigns
• Contacts: Manage donor contacts, tags, and activity history
• Transactions: View and update donation transactions
• Campaign Members: Manage peer-to-peer fundraising members
• Campaign Teams: View, manage, and delete fundraising teams
• Campaign Tickets: Create and manage event tickets per campaign
• Discount Codes: Create and manage campaign discount codes
• Households: Group contacts into households
• Messages: View sent messages
• Webhooks: Create and manage webhook subscriptions
• Pledges: View pledge commitments
• Tickets: Access event ticket information
• Payouts: View payout history
• Plans: Manage recurring donation plans
• Funds: Create, update, and delete fund designations

Installation

git clone https://github.com/johnnylinsf/givebutter-mcp.git
cd givebutter-mcp
npm install
npm run build

Configuration

Get Your Givebutter API Key

1. Log in to your Givebutter account
2. Go to Settings > Integrations > API
3. Generate a new API key or copy your existing one

Configure with Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "givebutter": {
      "command": "node",
      "args": ["/path/to/givebutter-mcp/dist/index.js"],
      "env": {
        "GIVEBUTTER_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configure with Claude Code

claude mcp add givebutter -e GIVEBUTTER_API_KEY=your-api-key -- node /path/to/givebutter-mcp/dist/index.js

Available Tools (65)

Campaigns

Tool	Description
list_campaigns	List all campaigns with optional filtering by scope
get_campaign	Get details of a specific campaign
create_campaign	Create a new campaign
update_campaign	Update an existing campaign
delete_campaign	Delete a campaign

Contacts

Tool	Description
list_contacts	List all contacts with optional email filter
get_contact	Get details of a specific contact
create_contact	Create a new contact
update_contact	Update an existing contact
delete_contact	Archive a contact (soft delete)
restore_contact	Restore an archived contact

Contact Activities

Tool	Description
list_contact_activities	List all activities for a contact with optional type filter
get_contact_activity	Get details of a specific contact activity
delete_contact_activity	Delete a contact activity

Contact Tags

Tool	Description
add_contact_tags	Add tags to a contact
remove_contact_tags	Remove tags from a contact
sync_contact_tags	Sync tags for a contact (replaces all existing tags)

Transactions

Tool	Description
list_transactions	List transactions with optional campaign/contact filter
get_transaction	Get details of a specific transaction
update_transaction	Update a transaction (notes, check info, fund, team, etc.)

Campaign Members

Tool	Description
list_campaign_members	List all members of a campaign
get_campaign_member	Get details of a specific member
delete_campaign_member	Remove a member from a campaign

Campaign Teams

Tool	Description
list_campaign_teams	List all teams in a campaign
get_campaign_team	Get details of a specific team
delete_campaign_team	Delete a team from a campaign

Campaign Tickets

Tool	Description
list_campaign_tickets	List all tickets for a campaign
get_campaign_ticket	Get details of a specific campaign ticket
create_campaign_ticket	Create a new ticket for a campaign

Discount Codes

Tool	Description
list_discount_codes	List all discount codes for a campaign
get_discount_code	Get details of a specific discount code
create_discount_code	Create a new discount code for a campaign
update_discount_code	Update an existing discount code
delete_discount_code	Delete a discount code

Households

Tool	Description
list_households	List all households
get_household	Get details of a specific household
create_household	Create a new household
update_household	Update an existing household
delete_household	Delete a household

Household Contacts

Tool	Description
list_household_contacts	List all contacts in a household
get_household_contact	Get a specific contact in a household
add_household_contact	Add a contact to a household
remove_household_contact	Remove a contact from a household

Messages

Tool	Description
list_messages	List all messages
get_message	Get details of a specific message

Webhooks

Tool	Description
list_webhooks	List all webhooks
get_webhook	Get details of a specific webhook
create_webhook	Create a new webhook
update_webhook	Update an existing webhook
delete_webhook	Delete a webhook

Webhook Activities

Tool	Description
list_webhook_activities	List all activities for a webhook
get_webhook_activity	Get details of a specific webhook activity

Pledges

Tool	Description
list_pledges	List all pledges
get_pledge	Get details of a specific pledge

Tickets

Tool	Description
list_tickets	List all tickets with optional campaign filter
get_ticket	Get details of a specific ticket

Payouts

Tool	Description
list_payouts	List all payouts
get_payout	Get details of a specific payout

Plans (Recurring Donations)

Tool	Description
list_plans	List all recurring donation plans
get_plan	Get details of a specific plan

Funds

Tool	Description
list_funds	List all funds/designations
get_fund	Get details of a specific fund
create_fund	Create a new fund/designation
update_fund	Update an existing fund/designation
delete_fund	Delete a fund/designation

Example Usage

Once configured, you can ask Claude questions like:

• "How many donors do we have for our end-of-year campaign?"
• "Show me the top donors this month"
• "List all our active campaigns"
• "What's the total raised for campaign ID 12345?"
• "Create a new campaign called 'Spring Fundraiser' with a goal of $10,000"
• "Show me the transaction details for donation #67890"
• "Add the tag 'major-donor' to contact #123"
• "Create a webhook for transaction.succeeded events"
• "List all households and their contacts"
• "Create a 20% discount code for our gala campaign"

API Documentation

For more information about the Givebutter API, see the official API documentation.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

• For issues with this MCP server, please open an issue
• For Givebutter API questions, contact Givebutter Support