Connect your AI Agents to Basecamp in minutes

Merge lets you securely connect your agents to Basecamp and thousands of tools instantly

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}
11
Copy Code

Open 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}
Copy Code
Copied!

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  }
Copy Code

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}
Copy Code

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

airtable
Airtable
anaplan
Anaplan
asana
Asana
box
Box
calendly
Calendly
clickup
ClickUp
confluence
Confluence
contentful
Contentful
datadog
Datadog
dropbox
Dropbox
figma
Figma
freshdesk
Freshdesk
front
Front
github
GitHub
gitlab
GitLab
gmail
Gmail
gong
Gong
google_calendar
Google Calendar
google_drive
Google Drive
google_sheets
Google Sheets
greenhouse
Greenhouse
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
linear
Linear
microsoft_teams
Microsoft Teams
miro
Miro
monday
Monday.com
notion
Notion
onedrive
OneDrive
outlook
Outlook
pipedrive
Pipedrive
quickbooks_online
QuickBooks Online
sapsf
SAP SuccessFactors
salesforce
Salesforce
sendgrid
SendGrid
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
slack
Slack
stripe
Stripe
teamwork
Teamwork.com
trello
Trello
weather
Weather
wikipedia
Wikipedia
workday
Workday
zendesk
Zendesk
zendesk_sell
Zendesk Sell
zohocrm
Zoho CRM
zohodesk
Zoho Desk
zoom
Zoom

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