MCP Server GitHub

Model Context Protocol

Your Teamwork.com site, as tools an AI client can discover and call.

The Teamwork.com MCP server publishes Projects, Desk, Spaces and Chat as a typed toolset. A connected client reads the catalogue below on connect, so it knows which operations exist and what each one needs — and every call runs with the permissions of the account that authorised it, nothing more.

4Products
14Toolsets
207Tools
107 / 100Read / write

Connecting a client

The hosted server speaks streamable HTTP and authenticates with OAuth. Point a client at the endpoint and it discovers everything on this page automatically.

Hosted endpoint

Loads every toolset. A local STDIO binary is available too — see the usage guide.

https://mcp.ai.teamwork.com

Profile endpoints

A narrower tool list keeps a client focused. Each profile is a fixed set of toolsets, served on its own path.

ProfileToolsets
https://mcp.ai.teamwork.com/analyst Projects — Projects, Tasks, People, Planning, Time, Content; Desk — Tickets, Customers, Admin
https://mcp.ai.teamwork.com/desk Desk — Tickets, Customers
https://mcp.ai.teamwork.com/knowledge-manager Spaces — Spaces, Pages, Content
https://mcp.ai.teamwork.com/ops Every toolset
https://mcp.ai.teamwork.com/project-manager Projects — Projects, Tasks, People, Planning, Content
https://mcp.ai.teamwork.com/support Desk — Tickets, Customers

The tool catalogue

Generated from the server's own toolset registry, so it matches what a client actually receives. Each toolset opens with a coverage matrix — which resources support create, get, list and update — followed by every tool it publishes.

207 tools

No tool matches that filter.

Projects

twprojects-​* · scope projects 133 tools · 6 toolsets

Content

twprojects-content

Comments, notebooks, milestones, tags, and activity feeds in Teamwork.com.

Resource coverage

ResourceCreateGetListUpdate
Activity——✓—
Comment✓✓✓✓
Milestone✓✓✓✓
Notebook✓✓✓✓
Tag✓✓✓✓
Message✓✓✓✓
Message Reply✓✓✓✓
Link✓✓✓✓

Tools

read twprojects-count_milestones Exact milestone count for any filter set: one call, one number, no rows.
write twprojects-create_comment Create comment on a task, milestone, notebook, file, or link.
write twprojects-create_link Create link.
write twprojects-create_message Create message in a project.
write twprojects-create_message_reply Create message reply.
write twprojects-create_milestone Create milestone in a project.
write twprojects-create_notebook Create notebook in a project.
write twprojects-create_tag Create tag.
read twprojects-get_comment Get comment.
read twprojects-get_link Get link.
read twprojects-get_message Get message.
read twprojects-get_message_reply Get message reply.
read twprojects-get_milestone Get milestone.
read twprojects-get_notebook Get notebook.
read twprojects-get_tag Get tag.
read twprojects-list_activities List recent activity events.
read twprojects-list_comments List comments.
read twprojects-list_links List links.
read twprojects-list_message_replies List replies under a message thread.
read twprojects-list_messages List project messages (top-level posts).
read twprojects-list_milestones List milestones.
read twprojects-list_notebooks List notebooks.
read twprojects-list_tags List tags.
read twprojects-search Cross-entity keyword search across projects, tasks, files, messages, and more.
write twprojects-update_comment Update comment.
write twprojects-update_link Update link.
write twprojects-update_message Update message.
write twprojects-update_message_reply Update message reply.
write twprojects-update_milestone Update milestone.
write twprojects-update_notebook Update notebook.
write twprojects-update_tag Update tag.

People

twprojects-people

Users, companies, teams, skills, and job roles in Teamwork.com.

Resource coverage

ResourceCreateGetListUpdate
Company✓✓✓✓
Industry——✓—
Job Role✓✓✓✓
Skill✓✓✓✓
Team✓✓✓✓
User✓✓✓✓
Current User (me)—✓——

Tools

write twprojects-create_company Create company (aka client).
write twprojects-create_jobrole Create job role.
write twprojects-create_skill Create skill.
write twprojects-create_team Create team.
write twprojects-create_user Create user.
read twprojects-get_company Get company (aka client).
read twprojects-get_jobrole Get job role.
read twprojects-get_skill Get skill.
read twprojects-get_team Get team.
read twprojects-get_user Get user.
read twprojects-get_user_me Get the currently authenticated user.
read twprojects-list_companies List companies (aka clients).
read twprojects-list_industries List supported company (aka client) industries.
read twprojects-list_jobroles List job roles.
read twprojects-list_skills List skills.
read twprojects-list_teams List teams.
read twprojects-list_users List users.
write twprojects-update_company Update company (aka client).
write twprojects-update_jobrole Update job role.
write twprojects-update_skill Update skill.
write twprojects-update_team Update team.
write twprojects-update_user Update user.

Planning

twprojects-planning

Resource scheduling in Teamwork.com: allocations, which commit a person's time to a project, and the workload view of the time their assigned tasks are estimated to take. The two are separate planes of planning and are not summed.

Resource coverage

ResourceCreateGetListUpdate
Allocation✓✓✓✓

Tools

write twprojects-create_allocation Commit a user's time to a project over a date range (a scheduler allocation).
read twprojects-get_allocation Get an allocation.
write twprojects-link_task_to_allocation Link one task to an allocation, showing what task work sits behind the committed time.
read twprojects-list_allocations List scheduler allocations — who is committed to which project, and when.
write twprojects-restore_allocation Restore a deleted allocation.
write twprojects-unlink_task_from_allocation Remove the link between one task and an allocation.
write twprojects-update_allocation Update an allocation.
read twprojects-users_workload Get task allocation across users for a date range.

Projects

twprojects-projects

Project, category, template, member, custom field, and custom item (user-defined entity types like Contracts, Leads, Deals) management in Teamwork.com.

Resource coverage

ResourceCreateGetListUpdate
Project Category✓✓✓✓
Project✓✓✓✓
Project Template✓—✓—
Custom Field✓✓✓✓
Custom Field Value✓✓✓✓
Custom Item✓✓✓✓
Custom Item Field✓✓✓✓
Custom Item Record✓✓✓✓
File✓———

Tools

write twprojects-add_project_member Add a user to a project.
write twprojects-clone_project Clone/copy an existing project or instantiate one from a template.
read twprojects-count_projects Exact project count for any filter set: one call, one number, no rows.
write twprojects-create_custom_field Create custom field.
write twprojects-create_custom_field_value Set a custom field value on a task, project or company.
write twprojects-create_custom_item Create a new custom item type (e.g. Contracts, Leads, Deals) on a project.
write twprojects-create_custom_item_field Add a field (column) to a custom item type.
write twprojects-create_custom_item_record Create a record (row) on a custom item type.
write twprojects-create_file Upload a file so it can be attached to a task, comment or message.
write twprojects-create_project Create project.
write twprojects-create_project_category Create project category.
write twprojects-create_project_template Create project template.
read twprojects-get_custom_field Get custom field.
read twprojects-get_custom_field_value Get a single custom field value from a task, project or company.
read 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.
read twprojects-get_custom_item_field Get a single field on a custom item type.
read twprojects-get_custom_item_record Get a single record.
read twprojects-get_project Get project.
read twprojects-get_project_category Get project category.
read twprojects-list_custom_field_values List the custom field values of a task, project or company.
read twprojects-list_custom_fields List custom fields.
read twprojects-list_custom_item_fields List fields on a custom item type.
read twprojects-list_custom_item_records List records on a custom item type.
read twprojects-list_custom_items List the custom item types defined on a project.
read twprojects-list_project_categories List project categories.
read twprojects-list_project_templates List project templates.
read twprojects-list_projects List projects with structured filters (membership, progress state, health, category, tag, company, owner).
write twprojects-update_custom_field Update custom field.
write twprojects-update_custom_field_value Update a custom field value on a task, project or company.
write twprojects-update_custom_item Update a custom item type's display name, description, or labels.
write twprojects-update_custom_item_field Update a field on a custom item type.
write twprojects-update_custom_item_record Update a record on a custom item type.
write twprojects-update_project Update project.
write twprojects-update_project_category Update project category.

Tasks

twprojects-tasks

Task, tasklist, and workflow management in Teamwork.com.

Resource coverage

ResourceCreateGetListUpdate
Task✓✓✓✓
Tasklist✓✓✓✓
Workflow✓✓✓✓
Workflow Stage✓✓✓✓

Tools

write twprojects-complete_task Mark task complete.
read twprojects-count_tasks Exact task count for any filter set: one call, one number, no rows.
write twprojects-create_task Create task in a tasklist.
write twprojects-create_tasklist Create tasklist in a project.
write twprojects-create_workflow Create workflow.
write twprojects-create_workflow_stage Create workflow stage.
read twprojects-get_task Get task.
read twprojects-get_tasklist Get tasklist.
read twprojects-get_workflow Get workflow.
read twprojects-get_workflow_stage Get workflow stage.
write twprojects-link_project_to_workflow Link a project to a workflow so its tasks track through workflow stages.
read twprojects-list_tasklists List tasklists.
read twprojects-list_tasks List tasks with structured filters (tasklist_id, project_id, or site-wide).
read twprojects-list_workflow_stages List workflow stages.
read twprojects-list_workflows List workflows.
write twprojects-move_task_to_workflow_stage Move one or more tasks to a workflow stage.
write twprojects-move_tasks Move tasks and all their subtasks to another tasklist, preserving the parent/child structure.
write twprojects-update_task Update task.
write twprojects-update_tasklist Update tasklist.
write twprojects-update_workflow Update workflow.
write twprojects-update_workflow_stage Update workflow stage.

Time

twprojects-time

Time tracking via timelogs, timers, calendars with time blocking, and budget reporting in Teamwork.com.

Resource coverage

ResourceCreateGetListUpdate
Calendar Event——✓—
Calendar——✓—
Project Budget——✓—
Tasklist Budget——✓—
Timelog✓✓✓✓
Timer✓✓✓✓

Tools

write twprojects-complete_timer Stop a timer permanently and convert it to a timelog.
read twprojects-count_timelogs Exact count of time entries for any filter set: one call, one number, no rows.
write twprojects-create_timelog Create timelog entry against a project or task.
write twprojects-create_timer Create and start a timer.
read twprojects-get_timelog Get timelog.
read twprojects-get_timer Get timer.
read 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.
read twprojects-list_calendars List calendars.
read twprojects-list_project_budgets Lists top-level project budgets.
read twprojects-list_tasklist_budgets List tasklist budgets nested under a project budget.
read twprojects-list_timelogs List timelogs.
read twprojects-list_timers List timers.
write twprojects-pause_timer Pause a running timer; can be resumed later.
write twprojects-resume_timer Resume a paused timer back to running.
read twprojects-summarize_timelogs Deterministic, complete time-tracking totals for a date window, grouped by user or project.
write twprojects-update_timelog Update timelog.
write twprojects-update_timer Update timer.

Desk

twdesk-​* · scope desk 42 tools · 4 toolsets

Admin

twdesk-admin

Inbox configuration: priorities, statuses, types, and tags in Teamwork Desk.

Resource coverage

ResourceCreateGetListUpdate
Priority✓✓✓✓
Status✓✓✓✓
Tag✓✓✓✓
Ticket Type✓✓✓✓

Tools

write twdesk-create_priority Create ticket priority.
write twdesk-create_status Create ticket status.
write twdesk-create_tag Create Desk tag.
write twdesk-create_ticket_type Create ticket type.
read twdesk-get_priority Get ticket priority.
read twdesk-get_status Get ticket status.
read twdesk-get_tag Get Desk tag.
read twdesk-get_ticket_type Get ticket type.
read twdesk-list_priorities List ticket priorities.
read twdesk-list_statuses List ticket statuses.
read twdesk-list_tags List Desk tags.
read twdesk-list_ticket_types List ticket types.
write twdesk-update_priority Update ticket priority.
write twdesk-update_status Update ticket status.
write twdesk-update_tag Update Desk tag.
write twdesk-update_ticket_type Update ticket type.

Customers

twdesk-customers

Companies, customers, and user management in Teamwork Desk.

Resource coverage

ResourceCreateGetListUpdate
Company✓✓✓✓
Customer✓✓✓✓
User—✓✓—

Tools

write twdesk-create_company Create Desk company.
write twdesk-create_customer Create customer.
read twdesk-get_company Get Desk company (customer organization).
read twdesk-get_customer Get customer.
read twdesk-get_user Get support agent.
read twdesk-list_companies List Desk companies.
read twdesk-list_customers List customers.
read twdesk-list_users List support agents.
write twdesk-update_company Update Desk company.
write twdesk-update_customer Update customer.

Helpdocs

twdesk-helpdocs

Help doc articles and sites in Teamwork Desk.

Resource coverage

ResourceCreateGetListUpdate
Helpdoc Article✓✓—✓
Helpdoc Site—✓✓—

Tools

write twdesk-create_helpdoc_article Create a new help doc article.
read twdesk-get_helpdoc_article Get a help doc article by ID.
read twdesk-get_helpdoc_site Get a help doc site (knowledge base) by ID, including its subdomain, branding and article counts.
read twdesk-list_helpdoc_sites List help doc sites (knowledge bases).
read twdesk-search_helpdoc_articles Search help doc articles.
write twdesk-update_helpdoc_article Update an existing help doc article.

Tickets

twdesk-tickets

Tickets, messages, files, and inboxes in Teamwork Desk.

Resource coverage

ResourceCreateGetListUpdate
Inbox—✓✓—
Ticket✓✓—✓
File✓———

Tools

write twdesk-create_file Upload file.
write twdesk-create_ticket Create ticket.
read twdesk-get_inbox Get inbox.
read twdesk-get_ticket Get ticket.
write twdesk-link_task_to_ticket Link a Teamwork Projects task to a Desk ticket, so the ticket shows the work tracked by that task.
read twdesk-list_inboxes List inboxes.
write twdesk-reply_ticket Reply to a ticket.
read twdesk-search_tickets Search tickets.
write twdesk-unlink_task_from_ticket Unlink a Teamwork Projects task from a Desk ticket.
write twdesk-update_ticket Update ticket.

Spaces

twspaces-​* · scope spaces 24 tools · 3 toolsets

Content

twspaces-content

Comments, tags, categories, and search in Teamwork Spaces.

Resource coverage

ResourceCreateGetListUpdate
Comment✓✓✓✓
Tag✓✓✓✓
Category✓✓✓✓

Tools

write twspaces-create_category Create space category.
write twspaces-create_comment Create comment on a page.
write twspaces-create_tags Create one or more Spaces tags in a single request.
read twspaces-get_category Get space category.
read twspaces-get_comment Get page comment.
read twspaces-get_tag Get Spaces tag.
read twspaces-list_categories List space categories.
read twspaces-list_comments List comments on a page.
read twspaces-list_tags List Spaces tags.
read twspaces-search Full-text search across pages.
write twspaces-update_category Update space category.
write twspaces-update_comment Update page comment.
write twspaces-update_tag Update Spaces tag.

Pages

twspaces-pages

Page CRUD, homepage, and duplication in Teamwork Spaces.

Resource coverage

ResourceCreateGetListUpdate
Page✓✓✓✓
Homepage—✓——

Tools

write twspaces-create_page Create page in a space.
write twspaces-duplicate_page Duplicate page with a new title.
read twspaces-get_homepage Get a space's homepage.
read twspaces-get_page Get page.
read twspaces-list_pages List pages in a space as a hierarchical tree.
write twspaces-update_page Update page.

Spaces

twspaces-spaces

Space CRUD and collaborators in Teamwork Spaces.

Resource coverage

ResourceCreateGetListUpdate
Space✓✓✓✓
Space Collaborator——✓—

Tools

write twspaces-create_space Create space.
read twspaces-get_space Get space.
read twspaces-list_space_collaborators List space collaborators (users and teams).
read twspaces-list_spaces List spaces.
write twspaces-update_space Update space.

Chat

twchat-​* · scope chat 8 tools · 1 toolsets

Chat

twchat-chat

Read conversations, messages, and people, and send messages in Teamwork Chat.

Resource coverage

ResourceCreateGetListUpdate
Current User—✓——
Conversation—✓✓—
Message——✓—
People——✓—

Tools

read twchat-get_conversation Get a single Teamwork Chat conversation by ID.
read twchat-get_current_user Get the current authenticated Teamwork Chat user, including identity, counts (unread conversations/messages, mentions), and settings.
write twchat-get_or_create_dm Get the 1:1 direct-message conversation with a person, creating it if it does not exist yet.
read twchat-list_conversations List Teamwork Chat conversations the current user is a member of.
read twchat-list_messages List messages within a Teamwork Chat conversation.
read twchat-list_people List people in the Teamwork Chat installation.
write twchat-send_dm Send a direct message to a person, resolving (or creating) the 1:1 conversation automatically.
write twchat-send_message Send a message to a Teamwork Chat conversation.

What bounds this surface

The catalogue above is the whole story for a hosted client — there is no second, wider set of tools behind it.

Your permissions, not more

Every call is made as the account that authorised the connection, so a client can only read and change what that person already could in the Teamwork.com UI.

Deletes are not published

Delete tools exist in the codebase but sit behind an allowDelete flag that no shipped server turns on, so no client can call one. That is why no delete_* tool appears above.

Read-only is one flag

Running a server with -read-only drops every write tool, leaving the 107 read tools listed above. Scopes narrow it further: a token carries one scope per product.