Teamwork MCP Server

com.teamwork/mcp

answering

Teamwork is answering right now. Last checked 8 min ago. It exposes 190 tools. Last commit 31 Jul 2026.

The Teamwork.com official MCP server helps teams efficiently manage client projects with AI.

Uptime history 40 hours of history · worst hour 43%

40 hours agonow

50.0%

Uptime 24h

91 of 182 checks

190

Tools

read from the server

484 ms

Response time

average over 24h

Stars

last commit 31 Jul 2026

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 8 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add mcp --transport http https://mcp.ai.teamwork.com

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.ai.teamwork.com"
    }
  }
}

~/.codex/config.toml

[mcp_servers.mcp]
url = "https://mcp.ai.teamwork.com"

.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.ai.teamwork.com"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.ai.teamwork.com"
    }
  }
}

Available tools 190

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

twprojects

twprojects-add_project_member

Add a user to a project.

twprojects-clone_project

Clone/copy an existing project or instantiate one from a template.

twprojects-complete_task

Mark task complete.

twprojects-complete_timer

Stop a timer permanently and convert it to a timelog. Use pause_timer to pause without converting.

twprojects-create_comment

Create comment on a task, milestone, notebook, file, or link.

twprojects-create_company

Create company (aka client).

twprojects-create_custom_field

Create custom field.

twprojects-create_custom_field_value

Set a custom field value on a task, project or company. The custom field must already exist and be applicable to the target entity.

twprojects-create_custom_item

Create a new custom item type (e.g. Contracts, Leads, Deals) on a project. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-create_custom_item_field

Add a field (column) to a custom item type. Field types include text, number, dropdown, multiselect, checkbox, url, user, date, time and datetime. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-create_custom_item_record

Create a record (row) on a custom item type. For example, add a Contract on the Contracts type. Pass field values by name; the tool resolves names to the API's internal IDs. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-create_jobrole

Create job role.

twprojects-create_link

Create link.

twprojects-create_message

Create message in a project.

twprojects-create_message_reply

Create message reply.

twprojects-create_milestone

Create milestone in a project.

twprojects-create_notebook

Create notebook in a project.

twprojects-create_project

Create project.

twprojects-create_project_category

Create project category.

twprojects-create_project_template

Create project template.

twprojects-create_skill

Create skill.

twprojects-create_tag

Create tag.

twprojects-create_task

Create task in a tasklist.

twprojects-create_tasklist

Create tasklist in a project.

twprojects-create_team

Create team.

twprojects-create_timelog

Create timelog entry against a project or task.

twprojects-create_timer

Create and start a timer.

twprojects-create_user

Create user.

twprojects-create_workflow

Create workflow.

twprojects-create_workflow_stage

Create workflow stage.

twprojects-get_comment

Get comment.

twprojects-get_company

Get company (aka client).

twprojects-get_custom_field

Get custom field.

twprojects-get_custom_field_value

Get a single custom field value from a task, project or company.

twprojects-get_custom_item

Get a custom item type with its fields and sections inline, so you can see its schema before creating or updating records. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-get_custom_item_field

Get a single field on a custom item type. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-get_custom_item_record

Get a single record. Field values come back keyed by display name with dropdown values translated to their human-readable labels. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-get_jobrole

Get job role.

twprojects-get_link

Get link.

twprojects-get_message

Get message.

twprojects-get_message_reply

Get message reply.

twprojects-get_milestone

Get milestone.

twprojects-get_notebook

Get notebook.

twprojects-get_project

Get project.

twprojects-get_project_category

Get project category.

twprojects-get_skill

Get skill.

twprojects-get_tag

Get tag.

twprojects-get_task

Get task.

twprojects-get_tasklist

Get tasklist.

twprojects-get_team

Get team.

twprojects-get_timelog

Get timelog.

twprojects-get_timer

Get timer.

twprojects-get_user

Get user.

twprojects-get_user_me

Get the currently authenticated user.

twprojects-get_workflow

Get workflow.

twprojects-get_workflow_stage

Get workflow stage.

twprojects-link_project_to_workflow

Link a project to a workflow so its tasks track through workflow stages.

twprojects-list_activities

List recent activity events. Scope by project_id or omit for site-wide.

twprojects-list_calendar_events

List events from a calendar, including time-blocking events that link a calendar slot to a Teamwork project, task or timelog. Use twprojects-list_calendars to find the calendar ID; the calendar of type 'blocked_time' holds the account's time-blocking events.

twprojects-list_calendars

List calendars. Calendars hold events such as meetings, out-of-office periods and time-blocking entries; the calendar of type 'blocked_time' holds the account's time-blocking events.

twprojects-list_comments

List comments. Scope by one of task_id, milestone_id, notebook_id, link_id, or file_version_id; omit all for site-wide.

twprojects-list_companies

List companies (aka clients).

twprojects-list_custom_field_values

List the custom field values of a task, project or company.

twprojects-list_custom_fields

List custom fields.

twprojects-list_custom_item_fields

List fields on a custom item type. Each entry includes the twId you need when writing record values. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-list_custom_item_records

List records on a custom item type. Returns each record with field values keyed by display name. Use the section_ids filter to scope to a specific section. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-list_custom_items

List the custom item types defined on a project. Returns each type's id, display name and labels — call get_custom_item to see a type's fields and sections. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-list_industries

List supported company (aka client) industries.

twprojects-list_jobroles

List job roles.

twprojects-list_links

List links.

twprojects-list_message_replies

List replies under a message thread. Filter by message_ids or project_ids.

twprojects-list_messages

List project messages (top-level posts). Use twprojects-list_message_replies for thread replies.

twprojects-list_milestones

List milestones. Scope by project_id or omit for site-wide.

twprojects-list_notebooks

List notebooks.

twprojects-list_project_budgets

List project budgets (top-level project financial budgets). Filter by project_ids or status.

twprojects-list_project_categories

List project categories.

twprojects-list_project_templates

List project templates.

twprojects-list_projects

List projects.

twprojects-list_skills

List skills.

twprojects-list_tags

List tags.

twprojects-list_tasklist_budgets

List tasklist budgets nested under a project budget. Requires project_budget_id.

twprojects-list_tasklists

List tasklists. Scope by project_id or omit for site-wide.

twprojects-list_tasks

List tasks with structured filters (tasklist_id, project_id, or site-wide). For keyword search use search.

twprojects-list_teams

List teams. Scope by company_id or project_id, or omit for site-wide.

twprojects-list_timelogs

List timelogs. Scope by project_id or task_id, or omit for site-wide.

twprojects-list_timers

List timers.

twprojects-list_users

List users. Scope by project_id or filter by type (account/collaborator/contact).

twprojects-list_workflow_stages

List workflow stages.

twprojects-list_workflows

List workflows.

twprojects-move_task_to_workflow_stage

Move a task to a workflow stage.

twprojects-pause_timer

Pause a running timer; can be resumed later. Use complete_timer to stop permanently.

twprojects-resume_timer

Resume a paused timer back to running.

twprojects-search

Cross-entity keyword search across projects, tasks, files, messages, and more.

twprojects-summarize_timelogs

Deterministic, complete time-tracking totals for a date window, grouped by user or project. Returns every group in one call with exact minute sums and 2-decimal hours — no pagination for the caller, any model tier. Use this instead of twprojects-list_timelogs whenever the question is about totals, sums, or breakdowns (e.g. "how many hours did X log", "time per project this month", billable vs billed vs unbilled); use list_timelogs only when you need the individual timelog entries. Minutes are exact and authoritative; hours are minutes ÷ 60 rounded to 2 decimals. unbilledBillable = billable − billed. The sum of the group columns equals the totals block exactly (reconcile in minutes, not hours).

twprojects-update_comment

Update comment.

twprojects-update_company

Update company (aka client).

twprojects-update_custom_field

Update custom field.

twprojects-update_custom_field_value

Update a custom field value on a task, project or company.

twprojects-update_custom_item

Update a custom item type's display name, description, or labels. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-update_custom_item_field

Update a field on a custom item type. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-update_custom_item_record

Update a record on a custom item type. Only the fields you supply are changed; others are left as-is. Set section_id to null to remove the record from any section. Custom items are user-defined entity types — Contracts, Leads, Deals, or anything else a customer has set up on a project. Use these tools when the user refers to an entity that is NOT a built-in Teamwork concept (Task, Tasklist, Project, Milestone, Comment, Notebook, Company, Team, User, Tag). If you don't recognise an entity name in the user's request, assume it is a custom item and call twprojects-list_custom_items on the relevant project to confirm.

twprojects-update_jobrole

Update job role.

twprojects-update_link

Update link.

twprojects-update_message

Update message.

twprojects-update_message_reply

Update message reply.

twprojects-update_milestone

Update milestone.

twprojects-update_notebook

Update notebook.

twprojects-update_project

Update project.

twprojects-update_project_category

Update project category.

twprojects-update_skill

Update skill.

twprojects-update_tag

Update tag.

twprojects-update_task

Update task.

twprojects-update_tasklist

Update tasklist.

twprojects-update_team

Update team.

twprojects-update_timelog

Update timelog.

twprojects-update_timer

Update timer.

twprojects-update_user

Update user.

twprojects-update_workflow

Update workflow.

twprojects-update_workflow_stage

Update workflow stage.

twprojects-users_workload

Get task allocation across users for a date range. (workload of users)

twdesk

twdesk-create_company

Create Desk company.

twdesk-create_customer

Create customer.

twdesk-create_file

Upload file. Attach the returned ID to tickets or messages.

twdesk-create_helpdoc_article

Create a new help doc article.

twdesk-create_priority

Create ticket priority.

twdesk-create_status

Create ticket status.

twdesk-create_tag

Create Desk tag.

twdesk-create_ticket

Create ticket.

twdesk-create_ticket_type

Create ticket type.

twdesk-get_company

Get Desk company (customer organization).

twdesk-get_customer

Get customer.

twdesk-get_helpdoc_article

Get a help doc article by ID.

twdesk-get_inbox

Get inbox.

twdesk-get_priority

Get ticket priority.

twdesk-get_status

Get ticket status.

twdesk-get_tag

Get Desk tag.

twdesk-get_ticket

Get ticket.

twdesk-get_ticket_type

Get ticket type.

twdesk-get_user

Get support agent.

twdesk-list_companies

List Desk companies. Filter by name, domains, or kind.

twdesk-list_customers

List customers. Filter by company or email.

twdesk-list_inboxes

List inboxes. Filter by name or email.

twdesk-list_priorities

List ticket priorities. Filter by name or color.

twdesk-list_statuses

List ticket statuses. Filter by name, color, or code.

twdesk-list_tags

List Desk tags. Filter by name, color, or inbox.

twdesk-list_ticket_types

List ticket types. Filter by name or inbox.

twdesk-list_users

List support agents. For customers, use twdesk-list_customers.

twdesk-reply_ticket

Reply to a ticket. Use threadType=note for internal agent notes.

twdesk-search_helpdoc_articles

Search help doc articles. Filter by search term, status, site, or category.

twdesk-search_tickets

Search tickets. Filter by inbox, customer, company, tag, status, priority, or user.

twdesk-update_company

Update Desk company.

twdesk-update_customer

Update customer.

twdesk-update_helpdoc_article

Update an existing help doc article.

twdesk-update_priority

Update ticket priority.

twdesk-update_status

Update ticket status.

twdesk-update_tag

Update Desk tag.

twdesk-update_ticket

Update ticket.

twdesk-update_ticket_type

Update ticket type.

twspaces

twspaces-create_category

Create space category.

twspaces-create_comment

Create comment on a page. Use parentId for replies.

twspaces-create_page

Create page in a space.

twspaces-create_space

Create space.

twspaces-create_tags

Create one or more Spaces tags in a single request.

twspaces-duplicate_page

Duplicate page with a new title.

twspaces-get_category

Get space category.

twspaces-get_comment

Get page comment.

twspaces-get_homepage

Get a space's homepage.

twspaces-get_page

Get page. Returns content, metadata, tags, and revision info.

twspaces-get_space

Get space.

twspaces-get_tag

Get Spaces tag.

twspaces-list_categories

List space categories.

twspaces-list_comments

List comments on a page. Returns top-level comments with replies.

twspaces-list_pages

List pages in a space as a hierarchical tree.

twspaces-list_space_collaborators

List space collaborators (users and teams).

twspaces-list_spaces

List spaces.

twspaces-list_tags

List Spaces tags.

twspaces-search

Full-text search across pages. Filter by space.

twspaces-update_category

Update space category.

twspaces-update_comment

Update page comment.

twspaces-update_page

Update page. Note: content and publish changes update the published page only, not the live collaborative editor draft; if the page has an active editor draft, re-publishing from the Spaces web editor can overwrite these changes (known Spaces limitation).

twspaces-update_space

Update space.

twspaces-update_tag

Update Spaces tag.

twchat

twchat-get_conversation

Get a single Teamwork Chat conversation by ID.

twchat-get_current_user

Get the current authenticated Teamwork Chat user, including identity, counts (unread conversations/messages, mentions), and settings.

twchat-get_or_create_dm

Get the 1:1 direct-message conversation with a person, creating it if it does not exist yet. Returns the conversation (use its id with send_message). Use list_people to find user_id.

twchat-list_conversations

List Teamwork Chat conversations the current user is a member of.

twchat-list_messages

List messages within a Teamwork Chat conversation. Requires conversation_id.

twchat-list_people

List people in the Teamwork Chat installation. Useful for resolving names to user IDs.

twchat-send_dm

Send a direct message to a person, resolving (or creating) the 1:1 conversation automatically. Requires user_id and body. Use list_people to find user_id.

twchat-send_message

Send a message to a Teamwork Chat conversation. Requires conversation_id and body.

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.ai.teamwork.com/sse	sse	answering	534 ms	9 min ago
https://mcp.ai.teamwork.com	streamable-http	answering	474 ms	8 min ago

Teamwork — questions

Answers built from our own checks of this server.

What can Teamwork do?

It exposes 190 tools, read directly from the server on our last check. Among them: twchat-get_conversation, twchat-get_current_user, twchat-get_or_create_dm, twchat-list_conversations, twchat-list_messages, twchat-list_people and 184 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Teamwork mostly used for?

Its tools cluster around twprojects, twdesk and twspaces. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Teamwork working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 182 checks got a reply (50.0%), average response time 484 ms. The bar chart above shows every period we have measured.

How do I connect Teamwork?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Teamwork need an API key?

No. Teamwork completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 190 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Teamwork?

It answers our handshake in 484 ms on average, which is faster than 24% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Teamwork open source?

Yes — it is published under the MIT licence, written in Go, 23 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.