Connect your AI Agents to Teamwork.com in minutes
Available tools
list_comments
List all comments on a specific resource (task, milestone, file, or notebook). Returns comments with their details including body content, author, and timestamps.
create_comment
Add a new comment to a resource (task, milestone, file, or notebook). Allows specifying the comment body and optionally notifying specific users.
update_comment
Update an existing comment's body content. The comment body is the only field that can be updated.
delete_comment
Permanently delete a comment from a resource. This action cannot be undone.
list_companies
List all companies (clients) in the Teamwork.com workspace with optional search filtering. Returns companies with their details including name, address, phone, website, and associated people/project counts.
get_company
Get detailed information about a specific company by its ID. Returns full company details including name, address, contact information, website, and associated people/project counts.
create_company
Create a new company (client) in the Teamwork.com workspace. Allows setting name, address, contact information, and website. Companies can be associated with projects and people.
update_company
Update an existing company's properties including name, phone, and website. Only provided fields will be updated.
delete_company
Permanently delete a company from the Teamwork.com workspace. This action cannot be undone. Associated projects will not be deleted but will lose their company association.
list_milestones
List milestones in the Teamwork.com workspace with optional filtering by project. Returns milestones with their details including name, description, deadline, status, and responsible parties.
get_milestone
Get detailed information about a specific milestone by its ID. Returns full milestone details including name, description, deadline, status, responsible parties, and associated task counts.
create_milestone
Create a new milestone within a project. Milestones represent key deadlines or deliverables. Allows setting name, deadline, description, and responsible parties.
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 Teamwork.com MCP server
FAQs on using Merge's Teamwork.com MCP server
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
