Teamwork MCP Server: All Tools and Schemas

Introduction

This MCP server connects to Teamwork.com, an AI-powered professional services automation platform that helps agencies, consultancies, IT service providers, and other client-focused businesses run projects, resources, and financials in one place. The server exposes a comprehensive set of tools spanning the entire Teamwork.com ecosystem, enabling AI assistants to manage work end-to-end without leaving the conversation.

The tools are organized into four main product areas. Teamwork Projects (twprojects-*) covers the core project management surface — projects, tasks, tasklists, milestones, comments, messages, notebooks, links, time tracking (timelogs and timers), workflows, custom fields, custom item types, budgets, teams, users, tags, skills, and workload reporting. Teamwork Desk (twdesk-*) handles customer support with tickets, inboxes, customers, companies, priorities, statuses, ticket types, help doc articles, and agents.

Teamwork Chat (twchat-*) provides messaging capabilities including conversations, direct messages, and people lookup, while Teamwork Spaces (twspaces-*) manages a knowledge base of collaborative pages, comments, categories, tags, and spaces. Together these tools let you create, read, update, search, and report across the full Teamwork.com suite — from logging billable time to spinning up projects from templates and forecasting team workload.

Use Cases

1. Project setup and cloning

Quickly stand up new client projects manually or from templates, then organize tasklists and milestones.

Sample prompt: Create a new project called "Acme Website Redesign" for the Acme company starting 2025-07-01, then add tasklists for Discovery, Design, and Development.
Sample prompt: Clone our "Client Onboarding Template" project into a new project called "Beta Corp Onboarding" starting today.

2. Task management and delegation

Create, assign, prioritize, and track tasks through completion and workflow stages.

Sample prompt: Create a high-priority task "Finalize homepage mockups" in tasklist 48291, assign it to user 1023, due next Friday, and estimate 4 hours.
Sample prompt: Show me all unassigned, unplanned tasks in project 55210 and list who created each one.

3. Time tracking and billable reporting

Log time, run timers, and produce exact profitability-focused totals grouped by user or project.

Sample prompt: Log 2 hours 30 minutes of billable time against task 88213 for today with the description "Client review call".
Sample prompt: Summarize all billable vs unbilled hours per project for the month of June 2025.

4. Resource and workload planning

See task allocation across the team to spot over- and under-utilization.

Sample prompt: Show me the workload for the design team between 2025-07-01 and 2025-07-15 and flag anyone over capacity.

5. Customer support ticket handling (Teamwork Desk)

Triage, reply to, and update support tickets, and manage inboxes, statuses, and priorities.

Sample prompt: Find all open high-priority tickets in the Support inbox, then reply to ticket 41022 letting the customer know a fix is on the way.
Sample prompt: Add an internal note to ticket 41055 assigning it to agent 88 and tag it as "escalation".

6. Customer and company (client) records management

Create and maintain customer and company records across both Projects and Desk.

Sample prompt: Create a new Desk company called "Northwind Traders" with the domain northwind.com and add a customer named Jane Doe with email jane@northwind.com.

7. Cross-entity and knowledge search

Search across projects, tasks, files, messages, help docs, and Spaces pages.

Sample prompt: Search all projects and tasks for anything mentioning "GDPR compliance" updated in the last month.
Sample prompt: Search our help docs for published articles about "password reset".

8. Team communication (Teamwork Chat)

Send direct messages and post to conversations, resolving people by name.

Sample prompt: Send a direct message to Sarah Kelly letting her know the design review is moved to 3pm tomorrow.
Sample prompt: Post a message in the "Project Leads" conversation summarizing this week's blockers.

9. Knowledge base authoring (Teamwork Spaces)

Create and maintain internal documentation pages, comments, and required reading.

Sample prompt: Create a page titled "Client Onboarding Checklist" in space 12 and publish it with our standard onboarding steps.
Sample prompt: Duplicate page 8842 as "2025 Style Guide" and mark it as required reading.

10. Custom items for bespoke workflows

Model non-standard entities like Contracts, Leads, or Deals with custom fields and records.

Sample prompt: List the custom item types on project 55210, then add a new "Contract" record named "Acme Retainer 2025" with a value of 24000 and status Active.

11. Custom fields and metadata

Define and populate custom fields on tasks, projects, and companies for richer reporting.

Sample prompt: Create a dropdown custom field called "Account Tier" with Gold, Silver, and Bronze options at the installation level, then set it to Gold on project 55210.

12. Messages, notebooks, and links collaboration

Centralize project discussions, reference docs, and shared resources.

Sample prompt: Post a project message titled "Sprint 3 Kickoff" to project 55210 notifying all members, and add a link to our shared Figma board.

13. Activity monitoring and status reporting

Review recent activity and comments to build status updates.

Sample prompt: Show me all activity in project 55210 over the last 7 days involving milestones and timelogs, then draft a client status summary.

14. Workflow management

Set up workflows and move tasks through stages for visual pipeline tracking.

Sample prompt: Create a workflow called "Content Pipeline" with stages Draft, Review, and Published, link it to project 55210, and move task 88213 into Review.

Details

MCP Server URL:

https://mcp.ai.teamwork.com

Type:

HTTP Stream

Authentication:

None

How to connect this MCP server

Tools

twprojects-get_task

Get task.

twprojects-list_tasks

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

twprojects-create_task

Create task in a tasklist.

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-update_task

Update task.

twprojects-list_projects

List projects.

twprojects-create_timelog

Create timelog entry against a project or task.

twprojects-list_timelogs

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

twprojects-search

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

twprojects-list_tasklists

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

twprojects-create_comment

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

twprojects-get_tasklist

Get tasklist.

twprojects-get_project

Get project.

twdesk-get_ticket

Get ticket.

twprojects-update_timelog

Update timelog.

twprojects-list_activities

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

twprojects-move_task_to_workflow_stage

Move a task to a workflow stage.

twprojects-complete_task

Mark task complete.

twdesk-search_tickets

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

twprojects-list_users

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

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.

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_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-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.

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_timer

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

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_tasklist

Create tasklist in a project.

twprojects-create_team

Create team.

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_category

Get project category.

twprojects-get_skill

Get skill.

twprojects-get_tag

Get tag.

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_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_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_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_teams

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

twprojects-list_timers

List timers.

twprojects-list_workflow_stages

List workflow stages.

twprojects-list_workflows

List workflows.

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-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_tasklist

Update tasklist.

twprojects-update_team

Update team.

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)

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.

Teamwork MCP Server