Connect your AI Agents to Basecamp in minutes

Available tools
list_comments
List all comments on a recording (todo, message, etc.). Returns paginated list of active comments.
get_comment
Get a specific comment by ID with full details including content and creator.
create_comment
Create a new comment on a recording (todo, message, etc.). Content must be HTML formatted.
update_comment
Update an existing comment's content. Content must be HTML formatted.
list_people
List all people visible to the current user in the Basecamp account.
get_person
Get a specific person by ID with full profile details.
get_current_user
Get the current authenticated user's profile.
get_project_people
Get all active people on a specific project.
list_projects
List all projects accessible to the user. Returns active projects by default. Use status to filter.
get_project
Get a specific project by ID with full details including dock items and tools.
create_project
Create a new project. Requires a name. Optional: description.
update_project
Update a project's name and/or description.

How to set up Merge Agent Handler
In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}FAQs on using Merge's Basecamp MCP server
FAQs on using Merge's Basecamp MCP server
What is a Basecamp MCP server?
It’s an MCP server that exposes data and functionality from an instance of Basecamp via tools. Your agents can call these tools to perform a wide range of tasks, from create a to-do task to updating a project’s name.
How can I use the Basecamp MCP server?
Here are just a few use cases (these also apply to other project management MCP servers):
- Project status reporting: Pull projects, to-dos, and milestones to generate a daily or weekly status update for a team
- Auto-create project plans: Create a new Basecamp project from a short prompt (project name, owners, key deliverables), then set up the initial to-do lists
- Meeting-to-workflow: Turn meeting notes into Basecamp to-dos, assign owners, and set due dates
- Task triage and assignment: Scan unassigned or overdue to-dos and propose (or apply) assignments and updated due dates
- Executive summaries: Summarize what changed since the last check-in across projects (new to-dos, completed work, risks)
- Cross-tool coordination: When work changes elsewhere (for example, an issue is marked “Ready” in Jira), create or update the corresponding Basecamp to-do
What are popular tools for Basecamp’s MCP server?
Here are a few tools across data types:
Comments
- <code class="blog_inline-code">list_comments</code>
- <code class="blog_inline-code">get_comment</code>
- <code class="blog_inline-code">create_comment</code>
- <code class="blog_inline-code">update_comment</code>
Projects
- <code class="blog_inline-code">list_projects</code>
- <code class="blog_inline-code">get_project</code>
- <code class="blog_inline-code">update_project</code>
To-dos
- <code class="blog_inline-code">update_todo</code>
- <code class="blog_inline-code">complete_todo</code>
- <code class="blog_inline-code">create_todo</code>
- <code class="blog_inline-code">uncomplete_todo</code>
What makes Merge Agent Handler’s Basecamp MCP server better than alternative Basecamp MCP servers?
Merge Agent Handler’s Basecamp MCP server offers more robust, enterprise-grade platform capabilities:
- Managed authentication and credential handling: Merge guides users through authorization and securely manages credentials for connected tools
- Enterprise-grade security and DLP: Tool inputs and outputs are scanned for sensitive data, with configurable rules to block, redact, or mask data
- Real-time observability and auditability: Merge provides activity logging for every tool call with fully searchable logs to support debugging and audits
- Evaluation before production: Tools can be validated against expected outcomes prior to deployment using the Evaluation Suite
Can I set custom security rules for Basecamp tool calls in Merge Agent Handler?
Yes. Merge Agent Handler includes a security gateway with Data Loss Protection (DLP) that allows default and custom rules to scan tool inputs and outputs and take actions such as blocking or redacting sensitive data.
Here are some examples:
- Block Social Security numbers from being posted into Basecamp (in messages, comments, or to-do descriptions)
- Block credit card numbers from being posted into Basecamp (in any text fields an agent can write)
- Redact email addresses and phone numbers before writing anything into Basecamp, so the action can proceed but contact info is removed from what gets sent
- Block any attempt to paste secrets into Basecamp (API keys, bearer tokens, passwords, or anything that looks like credentials)
- Block uploading sensitive files into Basecamp based on filename patterns (for example, “passport,” “w2,” “bank_statement,” “ssn”)
How can I start using Merge Agent Handler’s Basecamp MCP server?
You can take these steps:
1. Sign up for Merge Agent Handler (create a free account).
2. Create a Tool Pack (this is where you bundle the tools you want your agent to have).
3. Add the Basecamp connector to that Tool Pack.
4. Create a Registered User (this represents the identity that will authenticate and perform Basecamp actions through your agent).
5. Authenticate Basecamp for that Registered User (so tool calls have the right permissions).
6. Save the Tool Pack, then copy the MCP server URL from the Tool Pack setup for that Registered User.
7. Paste that MCP server URL into your agent client or IDE MCP configuration (for example, Cursor, Windsurf, or Claude Desktop), then refresh/restart the client.
8. Run a simple test prompt to confirm the Basecamp tools are available and generating logs (check the Logs page to verify tool calls are being captured).
Explore other MCP servers built and managed by Merge

















Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
