Bloomerang MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bloomerang MCP Server Find lapsed donors and prepare follow-up tasks."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bloomerang MCP server for ChatGPT and Claude
Bloomerang has a REST API for server-to-server integrations. The Cotlet.dev integration page reports no official Bloomerang MCP server, checked 22 October 2026. Cotlet.dev connects ChatGPT, Claude and other AI agents to constituents, gifts, interactions and duplicate records in your signed-in Bloomerang account. This repository provides a local MCP adapter to Cotlet.dev browser tools.
What you can ask
Find lapsed donors and prepare follow-up tasks.
Read a constituent record and gift history.
Record a check donation after I confirm the details.
Compare duplicate constituent records before I approve a merge.
Related MCP server: Batappli MCP Server
Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
ChatGPT
Settings → Apps & Connectors → Create, use https://cotlet.dev/mcp/v1/connect with OAuth, then sign in with Cotlet.dev. No API key needed.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Cursor
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}Run it locally (stdio)
This repo is a real MCP server. It speaks MCP over stdio, lists its Bloomerang tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
{"mcpServers":{"bloomerang":{"command":"uvx","args":["--from","git+https://github.com/cotlet-connect/bloomerang-mcp.git","bloomerang-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}Or with Docker:
docker build -t bloomerang-mcp .
docker run -i --rm -e COTLET_API_KEY bloomerang-mcpTools: bloomerang_guide, bloomerang_status, bloomerang_open, bloomerang_read, bloomerang_click, bloomerang_type, bloomerang_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
Command line
Python 3.10+, standard library only. Install from this repository:
pip install git+https://github.com/cotlet-connect/bloomerang-mcp.git
bloomerang-mcp connectOr straight from this repo:
export COTLET_API_KEY="your-key"
python3 bloomerang_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 bloomerang_agent.py status # is Bloomerang ready in your Cotlet.dev account
python3 bloomerang_agent.py guide # Bloomerang screens and sign-in link
python3 bloomerang_agent.py read # open Bloomerang, read the page, close the browser
python3 bloomerang_agent.py tools # list Cotlet.dev tools
python3 bloomerang_agent.py serve # start the stdio MCP server (same as no argument)Questions from Bloomerang users
Does Bloomerang have an API?
Yes. Bloomerang has a REST API for server-to-server integrations. Cotlet.dev works in your signed-in Bloomerang account and does not require a Bloomerang private API key.
Can ChatGPT and Claude work with Bloomerang?
Yes. Sign up at https://cotlet.dev/signup?app=bloomerang, enable Bloomerang and sign in using your Cotlet.dev Cloud Browser. Add Cotlet.dev as a connector in ChatGPT or Claude.
Can this charge a card or refund a gift?
No. The hosted record_donation operation records gifts that already arrived. It does not charge cards, refund gifts or delete donations.
What permissions apply?
Calls use the permissions of the Bloomerang account you sign in with. Recording gifts and merging constituents require the relevant permissions. These two operations ask for confirmation by default.
Is this official?
No. Cotlet.dev is independent and is not affiliated with Bloomerang.
Find it on
Also works with
Start free: https://cotlet.dev/signup?app=bloomerang&utm_source=github&utm_medium=readme&utm_campaign=bloomerang
Available Tools
7 toolsbloomerang_clickB
Click a numbered element on the current Bloomerang page.
Inputs: element (required).
bloomerang_closeA
Close the Bloomerang browser session when the work is done, so credits stop running.
Inputs: no named parameters.
bloomerang_guideA
How to work in Bloomerang (constituents, gifts, interactions and duplicate records): its screens and the sign-in link. Call this first.
Inputs: task.
bloomerang_openA
Open a Bloomerang page in your signed-in Cloud Browser (default https://crm.bloomerang.co) to work with constituents, gifts, interactions and duplicate records.
Inputs: url.
bloomerang_readB
Read the current Bloomerang page: its text and numbered buttons, links and fields.
Inputs: element.
bloomerang_statusA
Check that your Cotlet.dev account and Bloomerang are ready: account, credits and Bloomerang connection.
Inputs: no named parameters.
bloomerang_typeB
Type text into a numbered field on the current Bloomerang page.
Inputs: text (required), element (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool maps to a distinct step in the browser workflow: onboarding guidance, account status, opening a page, reading it, clicking, typing, and closing. The boundaries between open/read/click/type/close are clear, and guide vs status is also distinguishable.
All tools share the bloomerang_ prefix and use short lowercase names, giving a predictable pattern. Minor deviation: guide and status are nouns rather than verbs, while the rest are actions.
Seven tools is well-scoped for a browser-automation server focused on Bloomerang. Each tool covers a necessary part of the workflow without redundant actions.
The surface covers the core browser lifecycle: onboarding, status, open, read, click, type, and close. Minor gaps exist around advanced interactions like scrolling, explicit waits, file upload, or dropdown selection, though many can be worked around with click and type.
Related MCP Connectors
Bloomerang MCP server for ChatGPT, Claude and any AI agent: search constituents, record received gift, log interaction, create task, merge duplicate constituents and list lapsed donors in your own Bloomerang account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Bloomerang yourself; Cotlet does not store your password and you need no Bloomerang API key. About the official Bloomerang API: Yes, Bloomerang has a REST API for server-to-server integrations, but no MCP server for AI agents (checked 22 Oct 2026). An administrator creates the private key in User Settings under Edit My User, and that key can change any data in the database. Setup and FAQ: https://cotlet.dev/integrations/bloomerang-api-mcp-server
DonorPerfect MCP server for ChatGPT, Claude and any AI agent: search donors, add gift, apply pledge payment, create pledge, add contact, send thank-you email, list gifts waiting for a receipt and update donor in your own DonorPerfect account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to DonorPerfect yourself; Cotlet does not store your password and you need no DonorPerfect API key. About the official DonorPerfect API: DonorPerfect has an XML API with read and write access to donors, gifts, pledges and contacts, and no official MCP server (checked 23 Oct 2026). Calls are raw procedure or SELECT requests, and an admin generates the key under Settings > User Management > API Self Service. Setup and FAQ: https://cotlet.dev/integrations/donorperfect-api-mcp-server
Wild Apricot MCP server for ChatGPT, Claude and any AI agent: list contacts, approve membership application, check in event registrant, send email to event registrants, record invoice payment and register contact for event in your own Wild Apricot account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Wild Apricot yourself; Cotlet does not store your password and you need no Wild Apricot API key. About the official Wild Apricot API: Yes, Wild Apricot has a REST API with an admin side and a member side, but no official MCP server (checked 23 Oct 2026). Its help center calls the API "intended for use by developers": you authorize an application, get an API key, exchange it for an OAuth token and write the calls yourself. Setup and FAQ: https://cotlet.dev/integrations/wild-apricot-api-mcp-server
Agile CRM MCP server for ChatGPT, Claude and any AI agent: get campaign report, add contacts to campaign, list contacts, add contact tags, list deals, move deal to milestone, add note and create task in your own Agile CRM account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Agile CRM yourself; Cotlet does not store your password and you need no Agile CRM API key. About the official Agile CRM API: Yes, Agile CRM has a REST API on all plans, with a daily call cap by plan and no official MCP server (checked 22 Oct 2026). It covers contacts, companies, deals, tasks, notes, events, tracks and enrolling a contact in a campaign, but not campaign reports or bulk actions. Setup and FAQ: https://cotlet.dev/integrations/agile-crm-api-mcp-server
Related MCP Servers
- AlicenseAqualityBmaintenanceConnects a signed-in GoReminders account to ChatGPT, Claude, and other AI agents through Cotlet.dev, letting them read appointments and customer replies, manage reminders, and review booking requests, with write operations requiring approval before they run.7Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceEnables ChatGPT, Claude and other AI agents to work with clients, draft quotes, manage invoices and unpaid balances in a signed-in Batappli en ligne account via Cotlet.dev, with approval required for sharing, payments, conversions and reminders.Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceEnables ChatGPT, Claude, and other AI agents to access and manage Coach Catalyst accounts through Cotlet.dev, including clients, messages, check-ins, programs, and workouts via natural language.Elastic 2.0
- AlicenseNot gradedqualityCmaintenanceEnables ChatGPT, Claude, and other AI agents to connect to WodBoard through Cotlet.dev and use tools for CRM leads, memberships and class packs, payments and refunds, pricing, customer email exports, staff settings, shop products, content, and waitlists.Elastic 2.0