Teamwork

Teamwork

Tools for Teamwork.com products.

826

104 Tools

Packaged by
Requires Secrets
Add to Docker Desktop

Version 4.43 or later needs to be installed to add the server automatically

Use cases

About

Teamwork MCP Server

Tools for Teamwork.com products.

What is an MCP Server?

MCP Info

AttributeDetails
Docker Imagemcp/teamwork
AuthorTeamwork
Repositoryhttps://github.com/teamwork/mcp

Image Building InfoDockerfile|https://github.com/teamwork/mcp/blob/main/Dockerfile

Docker Image built by|Docker Inc. Docker Scout Health Score| Docker Scout Health ScoreVerify Signature|COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/teamwork --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pubLicence|MIT License

Available Tools (104)

Tools provided by this ServerShort Description
twdesk-create_companyCreate Company
twdesk-create_customerCreate Customer
twdesk-create_fileCreate File
twdesk-create_messageCreate Message
twdesk-create_priorityCreate Priority
twdesk-create_statusCreate Status
twdesk-create_tagCreate Tag
twdesk-create_ticketCreate Ticket
twdesk-create_typeCreate Type
twdesk-get_companyGet Company
twdesk-get_customerGet Customer
twdesk-get_inboxGet Inbox
twdesk-get_priorityGet Priority
twdesk-get_statusGet Status
twdesk-get_tagGet Tag
twdesk-get_ticketGet Ticket
twdesk-get_typeGet Type
twdesk-get_userGet User
twdesk-list_companiesList Companies
twdesk-list_customersList Customers
twdesk-list_inboxesList Inboxes
twdesk-list_prioritiesList Priorities
twdesk-list_statusesList Statuses
twdesk-list_tagsList Tags
twdesk-list_ticketsSearch Tickets
twdesk-list_typesList Types
twdesk-list_usersList Users
twdesk-update_companyUpdate Company
twdesk-update_customerUpdate Customer
twdesk-update_priorityUpdate Priority
twdesk-update_statusUpdate Status
twdesk-update_tagUpdate Tag
twdesk-update_ticketUpdate Ticket
twdesk-update_typeUpdate Type
twprojects-add_project_memberAdd Project Member
twprojects-complete_timerComplete Timer
twprojects-create_commentCreate Comment
twprojects-create_companyCreate Company
twprojects-create_milestoneCreate Milestone
twprojects-create_notebookCreate Notebook
twprojects-create_projectCreate Project
twprojects-create_tagCreate Tag
twprojects-create_taskCreate Task
twprojects-create_tasklistCreate Tasklist
twprojects-create_teamCreate Team
twprojects-create_timelogCreate Timelog
twprojects-create_timerCreate Timer
twprojects-create_userCreate User
twprojects-get_commentGet Comment
twprojects-get_companyGet Company
twprojects-get_milestoneGet Milestone
twprojects-get_notebookGet Notebook
twprojects-get_projectGet Project
twprojects-get_tagGet Tag
twprojects-get_taskGet Task
twprojects-get_tasklistGet Tasklist
twprojects-get_teamGet Team
twprojects-get_timelogGet Timelog
twprojects-get_timerGet Timer
twprojects-get_userGet User
twprojects-get_user_meGet Logged User
twprojects-list_activitiesList Activities
twprojects-list_activities_by_projectList Activities by Project
twprojects-list_commentsList Comments
twprojects-list_comments_by_file_versionList Comments by File Version
twprojects-list_comments_by_milestoneList Comments by Milestone
twprojects-list_comments_by_notebookList Comments by Notebook
twprojects-list_comments_by_taskList Comments by Task
twprojects-list_companiesList Companies
twprojects-list_industriesList Industries
twprojects-list_milestonesList Milestones
twprojects-list_milestones_by_projectList Milestones by Project
twprojects-list_notebooksList Notebooks
twprojects-list_projectsList Projects
twprojects-list_tagsList Tags
twprojects-list_tasklistsList Tasklists
twprojects-list_tasklists_by_projectList Tasklists By Project
twprojects-list_tasksList Tasks
twprojects-list_tasks_by_projectList Tasks By Project
twprojects-list_tasks_by_tasklistList Tasks By Tasklist
twprojects-list_teamsList Teams
twprojects-list_teams_by_companyList Teams By Company
twprojects-list_teams_by_projectList Teams By Project
twprojects-list_timelogsList Timelogs
twprojects-list_timelogs_by_projectList Timelogs By Project
twprojects-list_timelogs_by_taskList Timelogs By Task
twprojects-list_timersList Timers
twprojects-list_usersList Users
twprojects-list_users_by_projectList Users By Project
twprojects-pause_timerPause Timer
twprojects-resume_timerResume Timer
twprojects-update_commentUpdate Comment
twprojects-update_companyUpdate Company
twprojects-update_milestoneUpdate Milestone
twprojects-update_notebookUpdate Notebook
twprojects-update_projectUpdate Project
twprojects-update_tagUpdate Tag
twprojects-update_taskUpdate Task
twprojects-update_tasklistUpdate Tasklist
twprojects-update_teamUpdate Team
twprojects-update_timelogUpdate Timelog
twprojects-update_timerUpdate Timer
twprojects-update_userUpdate User
twprojects-users_workloadGet Users Workload

Tools Details

Tool: twdesk-create_company

Create a new company in Teamwork Desk by specifying its name, domains, and other attributes. Useful for onboarding new organizations, customizing Desk for business relationships, or adapting support processes.

ParametersTypeDescription
namestringThe name of the company.
descriptionstringoptionalThe description of the company.
detailsstringoptionalThe details of the company.
domainsarrayoptionalThe domains for the company.
industrystringoptionalThe industry of the company.
kindstringoptionalThe kind of the company.
notestringoptionalThe note for the company.
permissionstringoptionalThe permission level of the company.
websitestringoptionalThe website of the company.

Tool: twdesk-create_customer

Create a new customer in Teamwork Desk by specifying their name, contact details, and other attributes. Useful for onboarding new clients, customizing Desk for business relationships, or adapting support processes.

ParametersTypeDescription
addressstringoptionalThe address of the customer.
emailstringoptionalThe email of the customer.
extraDatastringoptionalThe extra data of the customer.
facebookURLstringoptionalThe Facebook URL of the customer.
firstNamestringoptionalThe first name of the customer.
jobTitlestringoptionalThe job title of the customer.
lastNamestringoptionalThe last name of the customer.
linkedinURLstringoptionalThe LinkedIn URL of the customer.
mobilestringoptionalThe mobile number of the customer.
notesstringoptionalThe notes of the customer.
organizationstringoptionalThe organization of the customer.
phonestringoptionalThe phone number of the customer.
twitterHandlestringoptionalThe Twitter handle of the customer.

Tool: twdesk-create_file

Upload a new file to Teamwork Desk, enabling attachment to tickets, articles, or other resources.

ParametersTypeDescription
datastringThe content of the file as a base64-encoded string.
mimeTypestringThe MIME type of the file.
namestringThe name of the file.
dispositionstringoptionalThe disposition of the file.

Tool: twdesk-create_message

Send a reply message to a ticket in Teamwork Desk by specifying the ticket ID and message body. Useful for automating ticket responses, integrating external communication systems, or customizing support workflows.

ParametersTypeDescription
bodystringThe body of the message.
ticketIDintegerThe ID of the ticket that the message will be sent to.

Tool: twdesk-create_priority

Create a new priority in Teamwork Desk by specifying its name and color. Useful for customizing ticket workflows, introducing new escalation levels, or adapting Desk to evolving support processes.

ParametersTypeDescription
namestringThe name of the priority.
colorstringoptionalThe color of the priority.

Tool: twdesk-create_status

Create a new status in Teamwork Desk by specifying its name, color, and display order. Useful for customizing ticket workflows, introducing new resolution states, or adapting Desk to evolving support processes.

ParametersTypeDescription
namestringThe name of the status.
colorstringoptionalThe color of the status.
displayOrderintegeroptionalThe display order of the status.

Tool: twdesk-create_tag

Create a new tag in Teamwork Desk by specifying its name and color. Useful for customizing ticket workflows, introducing new categories, or adapting Desk to evolving support processes.

ParametersTypeDescription
namestringThe name of the tag.
colorstringoptionalThe color of the tag.

Tool: twdesk-create_ticket

Create a new ticket in Teamwork Desk by specifying subject, description, priority, and status. "Useful for automating ticket creation, integrating external systems, or customizing support workflows.

ParametersTypeDescription
bodystringThe body of the ticket.
inboxIdinteger
				The inbox ID of the ticket. 
				Use the 'twdesk-list_inboxes' tool to find valid IDs.
			

subject|string|The subject of the ticket. agentId|integeroptional| The agent ID that the ticket should be assigned to. Use the 'twdesk-list_agents' tool to find valid IDs.

bcc|arrayoptional|An array of email addresses to BCC on ticket creation. cc|arrayoptional|An array of email addresses to CC on ticket creation. customerEmail|stringoptional| The email address of the customer. This is used to identify the customer in the system. Either the customerId or customerEmail is required to create a ticket.
If email is provided we will either find or create the customer.

customerId|integeroptional| The customer ID of the ticket. Use the 'twdesk-list_customers' tool to find valid IDs.

files|arrayoptional| An array of file IDs to attach to the ticket.
Use the 'twdesk-create_file' tool to upload files.

notifyCustomer|booleanoptional|Set to true if the the customer should be sent a copy of the ticket. priorityId|integeroptional| The priority of the ticket. Use the 'twdesk-list_priorities' tool to find valid IDs.

statusId|integeroptional| The status of the ticket. Use the 'twdesk-list_statuses' tool to find valid IDs.

tags|arrayoptional| An array of tag IDs to associate with the ticket. Tag IDs can be found by using the 'twdesk-list_tags' tool.

typeId|integeroptional| The type ID of the ticket. Use the 'twdesk-list_types' tool to find valid IDs.


Tool: twdesk-create_type

Create a new ticket type in Teamwork Desk by specifying its name, display order, and future inbox settings. Useful for customizing ticket workflows, introducing new categories, or adapting Desk to evolving support processes.

ParametersTypeDescription
namestringThe name of the type.
displayOrderintegeroptionalThe display order of the type.
enabledForFutureInboxesbooleanoptionalWhether the type is enabled for future inboxes.

Tool: twdesk-get_company

Retrieve detailed information about a specific company in Teamwork Desk by its ID. Useful for auditing company records, troubleshooting ticket associations, or integrating Desk company data into automation workflows.

ParametersTypeDescription
idintegerThe ID of the company to retrieve.

This tool is read-only. It does not modify its environment.


Tool: twdesk-get_customer

Retrieve detailed information about a specific customer in Teamwork Desk by their ID. Useful for auditing customer records, troubleshooting ticket associations, or integrating Desk customer data into automation workflows.

ParametersTypeDescription
idintegerThe ID of the customer to retrieve.

This tool is read-only. It does not modify its environment.


Tool: twdesk-get_inbox

Retrieve detailed information about a specific inbox in Teamwork Desk by its ID

ParametersTypeDescription
idintegerThe ID of the inbox to retrieve.

This tool is read-only. It does not modify its environment.


Tool: twdesk-get_priority

Retrieve detailed information about a specific priority in Teamwork Desk by its ID. Useful for inspecting priority attributes, troubleshooting ticket routing, or integrating Desk priority data into automation workflows.

ParametersTypeDescription
idintegerThe ID of the priority to retrieve.

This tool is read-only. It does not modify its environment.


Tool: twdesk-get_status

Retrieve detailed information about a specific status in Teamwork Desk by its ID. Useful for auditing status usage, troubleshooting ticket workflows, or integrating Desk status data into automation workflows.

ParametersTypeDescription
idintegerThe ID of the status to retrieve.

This tool is read-only. It does not modify its environment.


Tool: twdesk-get_tag

Retrieve detailed information about a specific tag in Teamwork Desk by its ID. Useful for auditing tag usage, troubleshooting ticket categorization, or integrating Desk tag data into automation workflows.

ParametersTypeDescription
idintegerThe ID of the tag to retrieve.

This tool is read-only. It does not modify its environment.


Tool: twdesk-get_ticket

Retrieve detailed information about a specific ticket in Teamwork Desk by its ID. Useful for auditing ticket records, troubleshooting support workflows, or integrating Desk ticket data into automation and reporting systems.

ParametersTypeDescription
idintegerThe ID of the ticket to retrieve.

This tool is read-only. It does not modify its environment.


Tool: twdesk-get_type

Retrieve detailed information about a specific ticket type in Teamwork Desk by its ID. Useful for auditing type usage, troubleshooting ticket categorization, or integrating Desk type data into automation workflows.

ParametersTypeDescription
idintegerThe ID of the type to retrieve.

This tool is read-only. It does not modify its environment.


Tool: twdesk-get_user

Retrieve detailed information about a specific user in Teamwork Desk by their ID. Useful for auditing user records, troubleshooting ticket assignments, or integrating Desk user data into automation workflows.

ParametersTypeDescription
idintegerThe ID of the user to retrieve.

This tool is read-only. It does not modify its environment.


Tool: twdesk-list_companies

List all companies in Teamwork Desk, with optional filters for name, domains, and kind. Enables users to audit, analyze, or synchronize company configurations for ticket management, reporting, or integration scenarios.

ParametersTypeDescription
domainsarrayoptionalThe domains of the company to filter by.
kindstringoptionalThe kind of the company to filter by.
namestringoptionalThe name of the company to filter by.
orderBystringoptionalThe field to order the results by.
orderDirectionstringoptionalThe direction to order the results by (asc, desc).
pageintegeroptionalThe page number to retrieve.
pageSizeintegeroptionalThe number of results to retrieve per page.

This tool is read-only. It does not modify its environment.


Tool: twdesk-list_customers

List all customers in Teamwork Desk, with optional filters for company, email, and other attributes. Enables users to audit, analyze, or synchronize customer configurations for ticket management, reporting, or integration scenarios.

ParametersTypeDescription
companyIDsarrayoptionalThe IDs of the companies to filter by.
companyNamesarrayoptionalThe names of the companies to filter by.
emailsarrayoptionalThe emails of the customers to filter by.
orderBystringoptionalThe field to order the results by.
orderDirectionstringoptionalThe direction to order the results by (asc, desc).
pageintegeroptionalThe page number to retrieve.
pageSizeintegeroptionalThe number of results to retrieve per page.

This tool is read-only. It does not modify its environment.


Tool: twdesk-list_inboxes

List all inboxes in Teamwork Desk, with optional filters for name and email.

ParametersTypeDescription
emailarrayoptionalThe email of the inbox to filter by.
namearrayoptionalThe name of the inbox to filter by.
orderBystringoptionalThe field to order the results by.
orderDirectionstringoptionalThe direction to order the results by (asc, desc).
pageintegeroptionalThe page number to retrieve.
pageSizeintegeroptionalThe number of results to retrieve per page.

This tool is read-only. It does not modify its environment.


Tool: twdesk-list_priorities

List all available priorities in Teamwork Desk, with optional filters for name and color. Enables users to audit, analyze, or synchronize priority configurations for ticket management, reporting, or integration scenarios.

ParametersTypeDescription
colorarrayoptionalThe color of the priority to filter by.
namearrayoptionalThe name of the priority to filter by.
orderBystringoptionalThe field to order the results by.
orderDirectionstringoptionalThe direction to order the results by (asc, desc).
pageintegeroptionalThe page number to retrieve.
pageSizeintegeroptionalThe number of results to retrieve per page.

This tool is read-only. It does not modify its environment.


Tool: twdesk-list_statuses

List all statuses in Teamwork Desk, with optional filters for name, color, and code. Enables users to audit, analyze, or synchronize status configurations for ticket management, reporting, or integration scenarios.

ParametersTypeDescription
codearrayoptionalThe code of the status to filter by.
colorarrayoptionalThe color of the status to filter by.
namearrayoptionalThe name of the status to filter by.
orderBystringoptionalThe field to order the results by.
orderDirectionstringoptionalThe direction to order the results by (asc, desc).
pageintegeroptionalThe page number to retrieve.
pageSizeintegeroptionalThe number of results to retrieve per page.

This tool is read-only. It does not modify its environment.


Tool: twdesk-list_tags

List all tags in Teamwork Desk, with optional filters for name, color, and inbox association. Enables users to audit, analyze, or synchronize tag configurations for ticket management, reporting, or integration scenarios.

ParametersTypeDescription
colorstringoptionalThe color of the tag to filter by.
inboxIDsarrayoptionalThe IDs of the inboxes to filter by.
namestringoptionalThe name of the tag to filter by.
orderBystringoptionalThe field to order the results by.
orderDirectionstringoptionalThe direction to order the results by (asc, desc).
pageintegeroptionalThe page number to retrieve.
pageSizeintegeroptionalThe number of results to retrieve per page.

This tool is read-only. It does not modify its environment.


Tool: twdesk-list_tickets

Search tickets in Teamwork Desk using various filters including inbox, customer, company, tag, status, priority, SLA, user, and more. This tool enables users to perform targeted searches for tickets, facilitating efficient support management, reporting, and integration with other systems.

ParametersTypeDescription
searchstring
			The search term to use for finding tickets.
			This can be part of the subject, body, or other ticket fields.
		

companyIDs|arrayoptional| The IDs of the companies to filter by. Company IDs can be found by using the 'twdesk-list_companies' tool.

customerIDs|arrayoptional| The IDs of the customers to filter by. Customer IDs can be found by using the 'twdesk-list_customers' tool.

inboxIDs|arrayoptional| The IDs of the inboxes to filter by. Inbox IDs can be found by using the 'twdesk-list_inboxes' tool.

orderBy|stringoptional|The field to order the results by. orderDirection|stringoptional|The direction to order the results by (asc, desc). page|integeroptional|The page number to retrieve. pageSize|integeroptional|The number of results to retrieve per page. priorityIDs|arrayoptional| The IDs of the priorities to filter by. Priority IDs can be found by using the 'twdesk-list_priorities' tool.

shared|booleanoptional| Find tickets shared with me outside of inboxes I have access to

slaBreached|booleanoptional| Find tickets where the SLA has been breached

statusIDs|arrayoptional| The IDs of the statuses to filter by. Status IDs can be found by using the 'twdesk-list_statuses' tool.

tagIDs|arrayoptional| The IDs of the tags to filter by. Tag IDs can be found by using the 'twdesk-list_tags' tool.

userIDs|arrayoptional| The IDs of the users to filter by. User IDs can be found by using the 'twdesk-list_users' tool.

This tool is read-only. It does not modify its environment.


Tool: twdesk-list_types

List all ticket types in Teamwork Desk, with optional filters for name and inbox association. Enables users to audit, analyze, or synchronize type configurations for ticket management, reporting, or integration scenarios.

ParametersTypeDescription
inboxIDsarrayoptionalThe inbox IDs of the type to filter by.
namearrayoptionalThe name of the type to filter by.
orderBystringoptionalThe field to order the results by.
orderDirectionstringoptionalThe direction to order the results by (asc, desc).
pageintegeroptionalThe page number to retrieve.
pageSizeintegeroptionalThe number of results to retrieve per page.

This tool is read-only. It does not modify its environment.


Tool: twdesk-list_users

List all users in Teamwork Desk, with optional filters for name, email, inbox, and part-time status. Enables users to audit, analyze, or synchronize user configurations for support management, reporting, or integration scenarios.

ParametersTypeDescription
emailarrayoptionalThe email addresses of the users to filter by.
firstNamearrayoptionalThe first names of the users to filter by.
inboxIDsarrayoptionalThe IDs of the inboxes to filter by.
isPartTimebooleanoptionalWhether to include part-time users in the results.
lastNamearrayoptionalThe last names of the users to filter by.
orderBystringoptionalThe field to order the results by.
orderDirectionstringoptionalThe direction to order the results by (asc, desc).
pageintegeroptionalThe page number to retrieve.
pageSizeintegeroptionalThe number of results to retrieve per page.

This tool is read-only. It does not modify its environment.


Tool: twdesk-update_company

Update an existing company in Teamwork Desk by ID, allowing changes to its name, domains, and other attributes. Supports evolving business relationships, rebranding, or correcting company records for improved ticket handling.

ParametersTypeDescription
idintegerThe ID of the company to update.
descriptionstringoptionalThe new description of the company.
detailsstringoptionalThe new details of the company.
domainsarrayoptionalThe new domains for the company.
industrystringoptionalThe new industry of the company.
kindstringoptionalThe new kind of the company.
namestringoptionalThe new name of the company.
notestringoptionalThe new note for the company.
permissionstringoptionalThe new permission level of the company.
websitestringoptionalThe new website of the company.

Tool: twdesk-update_customer

Update an existing customer in Teamwork Desk by ID, allowing changes to their name, contact details, and other attributes. Supports evolving business relationships, correcting customer records, or improving ticket handling.

ParametersTypeDescription
idintegerThe ID of the customer to update.
addressstringoptionalThe new address of the customer.
emailstringoptionalThe new email of the customer.
extraDatastringoptionalThe new extra data of the customer.
facebookURLstringoptionalThe new Facebook URL of the customer.
firstNamestringoptionalThe new first name of the customer.
jobTitlestringoptionalThe new job title of the customer.
lastNamestringoptionalThe new last name of the customer.
linkedinURLstringoptionalThe new LinkedIn URL of the customer.
mobilestringoptionalThe new mobile number of the customer.
notesstringoptionalThe new notes of the customer.
organizationstringoptionalThe new organization of the customer.
phonestringoptionalThe new phone number of the customer.
twitterHandlestringoptionalThe new Twitter handle of the customer.

Tool: twdesk-update_priority

Update an existing priority in Teamwork Desk by ID, allowing changes to its name and color. Supports evolving support policies, rebranding, or correcting priority attributes for improved ticket handling.

ParametersTypeDescription
idintegerThe ID of the priority to update.
colorstringoptionalThe color of the priority.
namestringoptionalThe new name of the priority.

Tool: twdesk-update_status

Update an existing status in Teamwork Desk by ID, allowing changes to its name, color, and display order. Supports evolving support policies, rebranding, or correcting status attributes for improved ticket handling.

ParametersTypeDescription
idintegerThe ID of the status to update.
colorstringoptionalThe color of the status.
displayOrderintegeroptionalThe display order of the status.
namestringoptionalThe new name of the status.

Tool: twdesk-update_tag

Update an existing tag in Teamwork Desk by ID, allowing changes to its name and color. Supports evolving support policies, rebranding, or correcting tag attributes for improved ticket handling.

ParametersTypeDescription
idintegerThe ID of the tag to update.
colorstringoptionalThe color of the tag.
namestringoptionalThe new name of the tag.

Tool: twdesk-update_ticket

Update an existing ticket in Teamwork Desk by ID, allowing changes to its attributes. Supports evolving support processes, correcting ticket records, or integrating with automation systems for improved ticket handling.

ParametersTypeDescription
idintegerThe ID of the ticket to update.
agentIdintegeroptional
				The agent ID that the ticket should be assigned to. 
				Use the 'twdesk-list_agents' tool to find valid IDs.
			

body|stringoptional|The body of the ticket. priorityId|integeroptional| The priority of the ticket. Use the 'twdesk-list_priorities' tool to find valid IDs.

statusId|integeroptional| The status of the ticket. Use the 'twdesk-list_statuses' tool to find valid IDs.

subject|stringoptional|The subject of the ticket. typeId|integeroptional| The type ID of the ticket. Use the 'twdesk-list_types' tool to find valid IDs.


Tool: twdesk-update_type

Update an existing ticket type in Teamwork Desk by ID, allowing changes to its name, display order, and future inbox settings. Supports evolving support policies, rebranding, or correcting type attributes for improved ticket handling.

ParametersTypeDescription
idintegerThe ID of the type to update.
displayOrderintegeroptionalThe display order of the type.
enabledForFutureInboxesbooleanoptionalWhether the type is enabled for future inboxes.
namestringoptionalThe new name of the type.

Tool: twprojects-add_project_member

Add a user to a project in Teamwork.com. In the context of Teamwork.com, a project member is a user who is assigned to a specific project. Project members can have different roles and permissions within the project, allowing them to collaborate on tasks, view project details, and contribute to the project's success. Managing project members effectively is crucial for ensuring that the right people are involved in the right tasks, and it helps maintain accountability and clarity throughout the project's lifecycle.

ParametersTypeDescription
project_idintegerThe ID of the project to add the member to.
user_idsarrayoptionalA list of user IDs to add to the project.

Tool: twprojects-complete_timer

Complete an existing timer in Teamwork.com. Timer is a built-in tool that allows users to accurately track the time they spend working on specific tasks, projects, or client work. Instead of manually recording hours, users can start, pause, and stop timers directly within the platform or through the desktop and mobile apps, ensuring precise time logs without interrupting their workflow. Once recorded, these entries are automatically linked to the relevant task or project, making it easier to monitor productivity, manage billable hours, and generate detailed reports for both internal tracking and client invoicing.

ParametersTypeDescription
idintegerThe ID of the timer to complete.

Tool: twprojects-create_comment

Create a new comment in Teamwork.com. In the Teamwork.com context, a comment is a way for users to communicate and collaborate directly within tasks, milestones, files, or other project items. Comments allow team members to provide updates, ask questions, give feedback, or share relevant information in a centralized and contextual manner. They support rich text formatting, file attachments, and @mentions to notify specific users or teams, helping keep discussions organized and easily accessible within the project. Comments are visible to all users with access to the item, promoting transparency and keeping everyone aligned.

ParametersTypeDescription
bodystringThe content of the comment. The content can be added as text or HTML.
objectobjectThe object to create the comment for. It can be a tasks, milestones, files or notebooks.
content_typestringoptionalThe content type of the comment. It can be either 'TEXT' or 'HTML'.

Tool: twprojects-create_company

Create a new company in Teamwork.com. In the context of Teamwork.com, a company represents an organization or business entity that can be associated with users, projects, and tasks within the platform, and it is often referred to as a “client.” It serves as a way to group related users and projects under a single organizational umbrella, making it easier to manage permissions, assign responsibilities, and organize work. Companies (or clients) are frequently used to distinguish between internal teams and external collaborators, enabling teams to work efficiently while maintaining clear boundaries around ownership, visibility, and access levels across different projects.

ParametersTypeDescription
namestringThe name of the company.
address_onestringoptionalThe first line of the address of the company.
address_twostringoptionalThe second line of the address of the company.
citystringoptionalThe city of the company.
country_codestringoptionalThe country code of the company, e.g., 'US' for the United States.
email_onestringoptionalThe primary email address of the company.
email_threestringoptionalThe tertiary email address of the company.
email_twostringoptionalThe secondary email address of the company.
faxstringoptionalThe fax number of the company.
industry_idintegeroptionalThe ID of the industry the company belongs to.
manager_idintegeroptionalThe ID of the user who manages the company.
phonestringoptionalThe phone number of the company.
profilestringoptionalA profile description for the company.
statestringoptionalThe state of the company.
tag_idsarrayoptionalA list of tag IDs to associate with the company.
websitestringoptionalThe website of the company.
zipstringoptionalThe ZIP or postal code of the company.

Tool: twprojects-create_milestone

Create a new milestone in Teamwork.com. In the context of Teamwork.com, a milestone represents a significant point or goal within a project that marks the completion of a major phase or a key deliverable. It acts as a high-level indicator of progress, helping teams track whether work is advancing according to plan. Milestones are typically used to coordinate efforts across different tasks and task lists, providing a clear deadline or objective that multiple team members or departments can align around. They don't contain individual tasks themselves but serve as checkpoints to ensure the project is moving in the right direction.

ParametersTypeDescription
assigneesobjectAn object containing assignees for the milestone. MUST contain at least one of: user_ids, company_ids or team_ids with non-empty arrays.
due_datestringThe due date of the milestone in the format YYYYMMDD. This date will be used in all tasks without a due date related to this milestone.
namestringThe name of the milestone.
project_idintegerThe ID of the project to create the milestone in.
descriptionstringoptionalA description of the milestone.
tag_idsarrayoptionalA list of tag IDs to associate with the milestone.
tasklist_idsarrayoptionalA list of tasklist IDs to associate with the milestone.

Tool: twprojects-create_notebook

Create a new notebook in Teamwork.com. Notebook is a space where teams can create, share, and organize written content in a structured way. It’s commonly used for documenting processes, storing meeting notes, capturing research, or drafting ideas that need to be revisited and refined over time. Unlike quick messages or task comments, notebooks provide a more permanent and organized format that can be easily searched and referenced, helping teams maintain a centralized source of knowledge and ensuring important information remains accessible to everyone who needs it.

ParametersTypeDescription
contentsstringThe contents of the notebook.
namestringThe name of the notebook.
project_idintegerThe ID of the project to create the notebook in.
typestringThe type of the notebook. Valid values are 'MARKDOWN' and 'HTML'.
descriptionstringoptionalA description of the notebook.
tag_idsarrayoptionalA list of tag IDs to associate with the notebook.

Tool: twprojects-create_project

Create a new project in Teamwork.com. The project feature in Teamwork.com serves as the central workspace for organizing and managing a specific piece of work or initiative. Each project provides a dedicated area where teams can plan tasks, assign responsibilities, set deadlines, and track progress toward shared goals. Projects include tools for communication, file sharing, milestones, and time tracking, allowing teams to stay aligned and informed throughout the entire lifecycle of the work. Whether it's a product launch, client engagement, or internal initiative, projects in Teamwork.com help teams structure their efforts, collaborate more effectively, and deliver results with greater visibility and accountability.

ParametersTypeDescription
namestringThe name of the project.
company_idintegeroptionalThe ID of the company associated with the project.
descriptionstringoptionalThe description of the project.
end_atstringoptionalThe end date of the project in the format YYYYMMDD.
owned_idintegeroptionalThe ID of the user who owns the project.
start_atstringoptionalThe start date of the project in the format YYYYMMDD.
tag_idsarrayoptionalA list of tag IDs to associate with the project.

Tool: twprojects-create_tag

Create a new tag in Teamwork.com. In the context of Teamwork.com, a tag is a customizable label that can be applied to various items such as tasks, projects, milestones, messages, and more, to help categorize and organize work efficiently. Tags provide a flexible way to filter, search, and group related items across the platform, making it easier for teams to manage complex workflows, highlight priorities, or track themes and statuses. Since tags are user-defined, they adapt to each team’s specific needs and can be color-coded for better visual clarity.

ParametersTypeDescription
namestringThe name of the tag. It must have less than 50 characters.
project_idintegeroptionalThe ID of the project to associate the tag with. This is for project-scoped tags.

Tool: twprojects-create_task

Create a new task in Teamwork.com. In Teamwork.com, a task represents an individual unit of work assigned to one or more team members within a project. Each task can include details such as a title, description, priority, estimated time, assignees, and due date, along with the ability to attach files, leave comments, track time, and set dependencies on other tasks. Tasks are organized within task lists, helping structure and sequence work logically. They serve as the building blocks of project management in Teamwork, allowing teams to collaborate, monitor progress, and ensure accountability throughout the project's lifecycle.

ParametersTypeDescription
namestringThe name of the task.
tasklist_idintegerThe ID of the tasklist. If you only have the project's name, use the twprojects-list_projects method with the search_term parameter to find the project ID, and then the twprojects-list_tasklists method with the project_id to choose the tasklist ID. If you know the tasklist's name, you may also use the search_term parameter with the twprojects-list_tasklists method to find the tasklist ID.
assigneesobjectoptionalAn object containing assignees for the task.
descriptionstringoptionalThe description of the task.
due_datestringoptionalThe due date of the task in ISO 8601 format (YYYY-MM-DD). When this is not provided, it will fallback to the milestone due date if a milestone is set.
estimated_minutesintegeroptionalThe estimated time to complete the task in minutes.
parent_task_idintegeroptionalThe ID of the parent task if creating a subtask.
predecessorsarrayoptionalList of task dependencies that must be completed before this task can start, defining its position in the project workflow and ensuring proper sequencing of work.
prioritystringoptionalThe priority of the task. Possible values are: low, medium, high.
progressintegeroptionalThe progress of the task, as a percentage (0-100). Only whole numbers are allowed.
start_datestringoptionalThe start date of the task in ISO 8601 format (YYYY-MM-DD).
tag_idsarrayoptionalA list of tag IDs to assign to the task.

Tool: twprojects-create_tasklist

Create a new tasklist in Teamwork.com. In the context of Teamwork.com, a task list is a way to group related tasks within a project, helping teams organize their work into meaningful sections such as phases, categories, or deliverables. Each task list belongs to a specific project and can include multiple tasks that are typically aligned with a common goal. Task lists can be associated with milestones, and they support privacy settings that control who can view or interact with the tasks they contain. This structure helps teams manage progress, assign responsibilities, and maintain clarity across complex projects.

ParametersTypeDescription
namestringThe name of the tasklist.
project_idintegerThe ID of the project to create the tasklist in.
descriptionstringoptionalThe description of the tasklist.
milestone_idintegeroptionalThe ID of the milestone to associate with the tasklist.

Tool: twprojects-create_team

Create a new team in Teamwork.com. In the context of Teamwork.com, a team is a group of users who are organized together to collaborate more efficiently on projects and tasks. Teams help structure work by grouping individuals with similar roles, responsibilities, or departmental functions, making it easier to assign work, track progress, and manage communication. By using teams, organizations can streamline project planning and ensure the right people are involved in the right parts of a project, enhancing clarity and accountability across the platform.

ParametersTypeDescription
namestringThe name of the team.
company_idintegeroptionalThe ID of the company. This is used to create a team scoped for a specific company.
descriptionstringoptionalThe description of the team.
handlestringoptionalThe handle of the team. It is a unique identifier for the team. It must not have spaces or special characters.
parent_team_idintegeroptionalThe ID of the parent team. This is used to create a hierarchy of teams.
project_idintegeroptionalThe ID of the project. This is used to create a team scoped for a specific project.
user_idsarrayoptionalA list of user IDs to add to the team.

Tool: twprojects-create_timelog

Create a new timelog in Teamwork.com. Timelog refers to a recorded entry that tracks the amount of time a person has spent working on a specific task, project, or piece of work. These entries typically include details such as the duration of time worked, the date and time it was logged, who logged it, and any optional notes describing what was done during that period. Timelogs are essential for understanding how time is being allocated across projects, enabling teams to manage resources more effectively, invoice clients accurately, and assess productivity. They can be created manually or with timers, and are often used for reporting and billing purposes.

ParametersTypeDescription
datestringThe date of the timelog in the format YYYY-MM-DD.
hoursintegerThe number of hours spent on the timelog. Must be a positive integer.
minutesintegerThe number of minutes spent on the timelog. Must be a positive integer less than 60, otherwise the hours attribute should be incremented.
timestringThe time of the timelog in the format HH:MM:SS.
billablebooleanoptionalIf true, the timelog is billable. Defaults to false.
descriptionstringoptionalA description of the timelog.
is_utcbooleanoptionalIf true, the time is in UTC. Defaults to false.
project_idintegeroptionalThe ID of the project to associate the timelog with. Either project_id or task_id must be provided, but not both.
tag_idsarrayoptionalA list of tag IDs to associate with the timelog.
task_idintegeroptionalThe ID of the task to associate the timelog with. Either project_id or task_id must be provided, but not both.
user_idintegeroptionalThe ID of the user to associate the timelog with. Defaults to the authenticated user if not provided.

Tool: twprojects-create_timer

Create a new timer in Teamwork.com. Timer is a built-in tool that allows users to accurately track the time they spend working on specific tasks, projects, or client work. Instead of manually recording hours, users can start, pause, and stop timers directly within the platform or through the desktop and mobile apps, ensuring precise time logs without interrupting their workflow. Once recorded, these entries are automatically linked to the relevant task or project, making it easier to monitor productivity, manage billable hours, and generate detailed reports for both internal tracking and client invoicing.

ParametersTypeDescription
project_idintegerThe ID of the project to associate the timer with.
billablebooleanoptionalIf true, the timer is billable. Defaults to false.
descriptionstringoptionalA description of the timer.
runningbooleanoptionalIf true, the timer will start running immediately.
secondsintegeroptionalThe number of seconds to set the timer for.
stop_running_timersbooleanoptionalIf true, any other running timers will be stopped when this timer is created.
task_idintegeroptionalThe ID of the task to associate the timer with.

Tool: twprojects-create_user

Create a new user in Teamwork.com. A user is an individual who has access to one or more projects within a Teamwork site, typically as a team member, collaborator, or administrator. Users can be assigned tasks, participate in discussions, log time, share files, and interact with other members depending on their permission levels. Each user has a unique profile that defines their role, visibility, and access to features and project data. Users can belong to clients/companies or teams within the system, and their permissions can be customized to control what actions they can perform or what information they can see.

ParametersTypeDescription
emailstringThe email address of the user.
first_namestringThe first name of the user.
last_namestringThe last name of the user.
adminbooleanoptionalIndicates whether the user is an administrator.
company_idintegeroptionalThe ID of the client/company to which the user belongs.
titlestringoptionalThe job title of the user, such as 'Project Manager' or 'Senior Software Developer'.
typestringoptionalThe type of user, such as 'account', 'collaborator', or 'contact'.

Tool: twprojects-get_comment

Get an existing comment in Teamwork.com. In the Teamwork.com context, a comment is a way for users to communicate and collaborate directly within tasks, milestones, files, or other project items. Comments allow team members to provide updates, ask questions, give feedback, or share relevant information in a centralized and contextual manner. They support rich text formatting, file attachments, and @mentions to notify specific users or teams, helping keep discussions organized and easily accessible within the project. Comments are visible to all users with access to the item, promoting transparency and keeping everyone aligned.

ParametersTypeDescription
idintegerThe ID of the comment to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_company

Get an existing company in Teamwork.com. In the context of Teamwork.com, a company represents an organization or business entity that can be associated with users, projects, and tasks within the platform, and it is often referred to as a “client.” It serves as a way to group related users and projects under a single organizational umbrella, making it easier to manage permissions, assign responsibilities, and organize work. Companies (or clients) are frequently used to distinguish between internal teams and external collaborators, enabling teams to work efficiently while maintaining clear boundaries around ownership, visibility, and access levels across different projects.

ParametersTypeDescription
idintegerThe ID of the company to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_milestone

Get an existing milestone in Teamwork.com. In the context of Teamwork.com, a milestone represents a significant point or goal within a project that marks the completion of a major phase or a key deliverable. It acts as a high-level indicator of progress, helping teams track whether work is advancing according to plan. Milestones are typically used to coordinate efforts across different tasks and task lists, providing a clear deadline or objective that multiple team members or departments can align around. They don't contain individual tasks themselves but serve as checkpoints to ensure the project is moving in the right direction.

ParametersTypeDescription
idintegerThe ID of the milestone to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_notebook

Get an existing notebook in Teamwork.com. Notebook is a space where teams can create, share, and organize written content in a structured way. It’s commonly used for documenting processes, storing meeting notes, capturing research, or drafting ideas that need to be revisited and refined over time. Unlike quick messages or task comments, notebooks provide a more permanent and organized format that can be easily searched and referenced, helping teams maintain a centralized source of knowledge and ensuring important information remains accessible to everyone who needs it.

ParametersTypeDescription
idintegerThe ID of the notebook to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_project

Get an existing project in Teamwork.com. The project feature in Teamwork.com serves as the central workspace for organizing and managing a specific piece of work or initiative. Each project provides a dedicated area where teams can plan tasks, assign responsibilities, set deadlines, and track progress toward shared goals. Projects include tools for communication, file sharing, milestones, and time tracking, allowing teams to stay aligned and informed throughout the entire lifecycle of the work. Whether it's a product launch, client engagement, or internal initiative, projects in Teamwork.com help teams structure their efforts, collaborate more effectively, and deliver results with greater visibility and accountability.

ParametersTypeDescription
idintegerThe ID of the project to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_tag

Get an existing tag in Teamwork.com. In the context of Teamwork.com, a tag is a customizable label that can be applied to various items such as tasks, projects, milestones, messages, and more, to help categorize and organize work efficiently. Tags provide a flexible way to filter, search, and group related items across the platform, making it easier for teams to manage complex workflows, highlight priorities, or track themes and statuses. Since tags are user-defined, they adapt to each team’s specific needs and can be color-coded for better visual clarity.

ParametersTypeDescription
idintegerThe ID of the tag to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_task

Get an existing task in Teamwork.com. In Teamwork.com, a task represents an individual unit of work assigned to one or more team members within a project. Each task can include details such as a title, description, priority, estimated time, assignees, and due date, along with the ability to attach files, leave comments, track time, and set dependencies on other tasks. Tasks are organized within task lists, helping structure and sequence work logically. They serve as the building blocks of project management in Teamwork, allowing teams to collaborate, monitor progress, and ensure accountability throughout the project's lifecycle.

ParametersTypeDescription
idintegerThe ID of the task to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_tasklist

Get an existing tasklist in Teamwork.com. In the context of Teamwork.com, a task list is a way to group related tasks within a project, helping teams organize their work into meaningful sections such as phases, categories, or deliverables. Each task list belongs to a specific project and can include multiple tasks that are typically aligned with a common goal. Task lists can be associated with milestones, and they support privacy settings that control who can view or interact with the tasks they contain. This structure helps teams manage progress, assign responsibilities, and maintain clarity across complex projects.

ParametersTypeDescription
idintegerThe ID of the tasklist to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_team

Get an existing team in Teamwork.com. In the context of Teamwork.com, a team is a group of users who are organized together to collaborate more efficiently on projects and tasks. Teams help structure work by grouping individuals with similar roles, responsibilities, or departmental functions, making it easier to assign work, track progress, and manage communication. By using teams, organizations can streamline project planning and ensure the right people are involved in the right parts of a project, enhancing clarity and accountability across the platform.

ParametersTypeDescription
idintegerThe ID of the team to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_timelog

Get an existing timelog in Teamwork.com. Timelog refers to a recorded entry that tracks the amount of time a person has spent working on a specific task, project, or piece of work. These entries typically include details such as the duration of time worked, the date and time it was logged, who logged it, and any optional notes describing what was done during that period. Timelogs are essential for understanding how time is being allocated across projects, enabling teams to manage resources more effectively, invoice clients accurately, and assess productivity. They can be created manually or with timers, and are often used for reporting and billing purposes.

ParametersTypeDescription
idintegerThe ID of the timelog to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_timer

Get an existing timer in Teamwork.com. Timer is a built-in tool that allows users to accurately track the time they spend working on specific tasks, projects, or client work. Instead of manually recording hours, users can start, pause, and stop timers directly within the platform or through the desktop and mobile apps, ensuring precise time logs without interrupting their workflow. Once recorded, these entries are automatically linked to the relevant task or project, making it easier to monitor productivity, manage billable hours, and generate detailed reports for both internal tracking and client invoicing.

ParametersTypeDescription
idintegerThe ID of the timer to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_user

Get an existing user in Teamwork.com. A user is an individual who has access to one or more projects within a Teamwork site, typically as a team member, collaborator, or administrator. Users can be assigned tasks, participate in discussions, log time, share files, and interact with other members depending on their permission levels. Each user has a unique profile that defines their role, visibility, and access to features and project data. Users can belong to clients/companies or teams within the system, and their permissions can be customized to control what actions they can perform or what information they can see.

ParametersTypeDescription
idintegerThe ID of the user to get.

This tool is read-only. It does not modify its environment.


Tool: twprojects-get_user_me

Get the logged user in Teamwork.com. A user is an individual who has access to one or more projects within a Teamwork site, typically as a team member, collaborator, or administrator. Users can be assigned tasks, participate in discussions, log time, share files, and interact with other members depending on their permission levels. Each user has a unique profile that defines their role, visibility, and access to features and project data. Users can belong to clients/companies or teams within the system, and their permissions can be customized to control what actions they can perform or what information they can see.

Tool: twprojects-list_activities

List activities in Teamwork.com. Activity is a record of actions and updates that occur across your projects, tasks, and communications, giving you a clear view of what’s happening within your workspace. Activities capture changes such as task completions, activities added, files uploaded, or milestones updated, and present them in a chronological feed so teams can stay aligned without needing to check each individual project or task. This stream of information helps improve transparency, ensures accountability, and keeps everyone aware of progress and decisions as they happen.

ParametersTypeDescription
end_datestringoptionalEnd date to filter activities. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.
log_item_typesarrayoptionalFilter activities by item types.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
start_datestringoptionalStart date to filter activities. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_activities_by_project

List activities in Teamwork.com by project. Activity is a record of actions and updates that occur across your projects, tasks, and communications, giving you a clear view of what’s happening within your workspace. Activities capture changes such as task completions, activities added, files uploaded, or milestones updated, and present them in a chronological feed so teams can stay aligned without needing to check each individual project or task. This stream of information helps improve transparency, ensures accountability, and keeps everyone aware of progress and decisions as they happen.

ParametersTypeDescription
end_datestringoptionalEnd date to filter activities. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.
log_item_typesarrayoptionalFilter activities by item types.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
project_idintegeroptionalThe ID of the project to retrieve activities from.
start_datestringoptionalStart date to filter activities. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_comments

List comments in Teamwork.com. In the Teamwork.com context, a comment is a way for users to communicate and collaborate directly within tasks, milestones, files, or other project items. Comments allow team members to provide updates, ask questions, give feedback, or share relevant information in a centralized and contextual manner. They support rich text formatting, file attachments, and @mentions to notify specific users or teams, helping keep discussions organized and easily accessible within the project. Comments are visible to all users with access to the item, promoting transparency and keeping everyone aligned.

ParametersTypeDescription
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter comments by name.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_comments_by_file_version

List comments in Teamwork.com by file version. In the Teamwork.com context, a comment is a way for users to communicate and collaborate directly within tasks, milestones, files, or other project items. Comments allow team members to provide updates, ask questions, give feedback, or share relevant information in a centralized and contextual manner. They support rich text formatting, file attachments, and @mentions to notify specific users or teams, helping keep discussions organized and easily accessible within the project. Comments are visible to all users with access to the item, promoting transparency and keeping everyone aligned.

ParametersTypeDescription
file_version_idintegerThe ID of the file version to retrieve comments for. Each file can have multiple versions, and comments can be associated with specific versions.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter comments by name.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_comments_by_milestone

List comments in Teamwork.com by milestone. In the Teamwork.com context, a comment is a way for users to communicate and collaborate directly within tasks, milestones, files, or other project items. Comments allow team members to provide updates, ask questions, give feedback, or share relevant information in a centralized and contextual manner. They support rich text formatting, file attachments, and @mentions to notify specific users or teams, helping keep discussions organized and easily accessible within the project. Comments are visible to all users with access to the item, promoting transparency and keeping everyone aligned.

ParametersTypeDescription
milestone_idintegerThe ID of the milestone to retrieve comments for.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter comments by name.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_comments_by_notebook

List comments in Teamwork.com by notebook. In the Teamwork.com context, a comment is a way for users to communicate and collaborate directly within tasks, milestones, files, or other project items. Comments allow team members to provide updates, ask questions, give feedback, or share relevant information in a centralized and contextual manner. They support rich text formatting, file attachments, and @mentions to notify specific users or teams, helping keep discussions organized and easily accessible within the project. Comments are visible to all users with access to the item, promoting transparency and keeping everyone aligned.

ParametersTypeDescription
notebook_idintegerThe ID of the notebook to retrieve comments for.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter comments by name.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_comments_by_task

List comments in Teamwork.com by task. In the Teamwork.com context, a comment is a way for users to communicate and collaborate directly within tasks, milestones, files, or other project items. Comments allow team members to provide updates, ask questions, give feedback, or share relevant information in a centralized and contextual manner. They support rich text formatting, file attachments, and @mentions to notify specific users or teams, helping keep discussions organized and easily accessible within the project. Comments are visible to all users with access to the item, promoting transparency and keeping everyone aligned.

ParametersTypeDescription
task_idintegerThe ID of the task to retrieve comments for.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter comments by name.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_companies

List companies in Teamwork.com. In the context of Teamwork.com, a company represents an organization or business entity that can be associated with users, projects, and tasks within the platform, and it is often referred to as a “client.” It serves as a way to group related users and projects under a single organizational umbrella, making it easier to manage permissions, assign responsibilities, and organize work. Companies (or clients) are frequently used to distinguish between internal teams and external collaborators, enabling teams to work efficiently while maintaining clear boundaries around ownership, visibility, and access levels across different projects.

ParametersTypeDescription
match_all_tagsbooleanoptionalIf true, the search will match companies that have all the specified tags. If false, the search will match companies that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter companies by name. Each word from the search term is used to match against the company name.
tag_idsarrayoptionalA list of tag IDs to filter companies by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_industries

List industries in Teamwork.com. Industry refers to the business sector or market category that a company belongs to, such as technology, healthcare, finance, or education. It helps provide context about the nature of a company's work and can be used to better organize and filter data across the platform. By associating companies and projects with specific industries, Teamwork.com allows teams to gain clearer insights, tailor communication, and segment information in ways that make it easier to manage relationships and understand the broader business landscape in which their clients and partners operate.

Tool: twprojects-list_milestones

List milestones in Teamwork.com. In the context of Teamwork.com, a milestone represents a significant point or goal within a project that marks the completion of a major phase or a key deliverable. It acts as a high-level indicator of progress, helping teams track whether work is advancing according to plan. Milestones are typically used to coordinate efforts across different tasks and task lists, providing a clear deadline or objective that multiple team members or departments can align around. They don't contain individual tasks themselves but serve as checkpoints to ensure the project is moving in the right direction.

ParametersTypeDescription
match_all_tagsbooleanoptionalIf true, the search will match milestones that have all the specified tags. If false, the search will match milestones that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter milestones by name. Each word from the search term is used to match against the milestone name and description. The milestone will be selected if each word of the term matches the milestone name or description, not requiring that the word matches are in the same field.
tag_idsarrayoptionalA list of tag IDs to filter milestones by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_milestones_by_project

List milestones in Teamwork.com by project. In the context of Teamwork.com, a milestone represents a significant point or goal within a project that marks the completion of a major phase or a key deliverable. It acts as a high-level indicator of progress, helping teams track whether work is advancing according to plan. Milestones are typically used to coordinate efforts across different tasks and task lists, providing a clear deadline or objective that multiple team members or departments can align around. They don't contain individual tasks themselves but serve as checkpoints to ensure the project is moving in the right direction.

ParametersTypeDescription
project_idintegerThe ID of the project from which to retrieve milestones.
match_all_tagsbooleanoptionalIf true, the search will match milestones that have all the specified tags. If false, the search will match milestones that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter milestones by name. Each word from the search term is used to match against the milestone name and description. The milestone will be selected if each word of the term matches the milestone name or description, not requiring that the word matches are in the same field.
tag_idsarrayoptionalA list of tag IDs to filter milestones by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_notebooks

List notebooks in Teamwork.com. Notebook is a space where teams can create, share, and organize written content in a structured way. It’s commonly used for documenting processes, storing meeting notes, capturing research, or drafting ideas that need to be revisited and refined over time. Unlike quick messages or task comments, notebooks provide a more permanent and organized format that can be easily searched and referenced, helping teams maintain a centralized source of knowledge and ensuring important information remains accessible to everyone who needs it.

ParametersTypeDescription
include_contentsbooleanoptionalIf true, the contents of the notebook will be included in the response. Defaults to true.
match_all_tagsbooleanoptionalIf true, the search will match notebooks that have all the specified tags. If false, the search will match notebooks that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
project_idsarrayoptionalA list of project IDs to filter notebooks by projects
search_termstringoptionalA search term to filter notebooks by name or description. The notebook will be selected if each word of the term matches the notebook name or description, not requiring that the word matches are in the same field.
tag_idsarrayoptionalA list of tag IDs to filter notebooks by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_projects

List projects in Teamwork.com. The project feature in Teamwork.com serves as the central workspace for organizing and managing a specific piece of work or initiative. Each project provides a dedicated area where teams can plan tasks, assign responsibilities, set deadlines, and track progress toward shared goals. Projects include tools for communication, file sharing, milestones, and time tracking, allowing teams to stay aligned and informed throughout the entire lifecycle of the work. Whether it's a product launch, client engagement, or internal initiative, projects in Teamwork.com help teams structure their efforts, collaborate more effectively, and deliver results with greater visibility and accountability.

ParametersTypeDescription
match_all_tagsbooleanoptionalIf true, the search will match projects that have all the specified tags. If false, the search will match projects that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter projects by name or description.
tag_idsarrayoptionalA list of tag IDs to filter projects by tags.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_tags

List tags in Teamwork.com. In the context of Teamwork.com, a tag is a customizable label that can be applied to various items such as tasks, projects, milestones, messages, and more, to help categorize and organize work efficiently. Tags provide a flexible way to filter, search, and group related items across the platform, making it easier for teams to manage complex workflows, highlight priorities, or track themes and statuses. Since tags are user-defined, they adapt to each team’s specific needs and can be color-coded for better visual clarity.

ParametersTypeDescription
item_typestringoptionalThe type of item to filter tags by. Valid values are 'project', 'task', 'tasklist', 'milestone', 'message', 'timelog', 'notebook', 'file', 'company' and 'link'.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
project_idsarrayoptionalA list of project IDs to filter tags by projects
search_termstringoptionalA search term to filter tags by name. Each word from the search term is used to match against the tag name.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_tasklists

List tasklists in Teamwork.com. In the context of Teamwork.com, a task list is a way to group related tasks within a project, helping teams organize their work into meaningful sections such as phases, categories, or deliverables. Each task list belongs to a specific project and can include multiple tasks that are typically aligned with a common goal. Task lists can be associated with milestones, and they support privacy settings that control who can view or interact with the tasks they contain. This structure helps teams manage progress, assign responsibilities, and maintain clarity across complex projects.

ParametersTypeDescription
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter tasklists by name.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_tasklists_by_project

List tasklists in Teamwork.com by project. In the context of Teamwork.com, a task list is a way to group related tasks within a project, helping teams organize their work into meaningful sections such as phases, categories, or deliverables. Each task list belongs to a specific project and can include multiple tasks that are typically aligned with a common goal. Task lists can be associated with milestones, and they support privacy settings that control who can view or interact with the tasks they contain. This structure helps teams manage progress, assign responsibilities, and maintain clarity across complex projects.

ParametersTypeDescription
project_idintegerThe ID of the project from which to retrieve tasklists.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter tasklists by name.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_tasks

List tasks in Teamwork.com. In Teamwork.com, a task represents an individual unit of work assigned to one or more team members within a project. Each task can include details such as a title, description, priority, estimated time, assignees, and due date, along with the ability to attach files, leave comments, track time, and set dependencies on other tasks. Tasks are organized within task lists, helping structure and sequence work logically. They serve as the building blocks of project management in Teamwork, allowing teams to collaborate, monitor progress, and ensure accountability throughout the project's lifecycle.

ParametersTypeDescription
assignee_user_idsarrayoptionalA list of user IDs to filter tasks by assigned users
match_all_tagsbooleanoptionalIf true, the search will match tasks that have all the specified tags. If false, the search will match tasks that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter tasks by name.
tag_idsarrayoptionalA list of tag IDs to filter tasks by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_tasks_by_project

List tasks in Teamwork.com by project. In Teamwork.com, a task represents an individual unit of work assigned to one or more team members within a project. Each task can include details such as a title, description, priority, estimated time, assignees, and due date, along with the ability to attach files, leave comments, track time, and set dependencies on other tasks. Tasks are organized within task lists, helping structure and sequence work logically. They serve as the building blocks of project management in Teamwork, allowing teams to collaborate, monitor progress, and ensure accountability throughout the project's lifecycle.

ParametersTypeDescription
project_idintegerThe ID of the project from which to retrieve tasks.
assignee_user_idsarrayoptionalA list of user IDs to filter tasks by assigned users
match_all_tagsbooleanoptionalIf true, the search will match tasks that have all the specified tags. If false, the search will match tasks that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter tasks by name.
tag_idsarrayoptionalA list of tag IDs to filter tasks by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_tasks_by_tasklist

List tasks in Teamwork.com by tasklist. In Teamwork.com, a task represents an individual unit of work assigned to one or more team members within a project. Each task can include details such as a title, description, priority, estimated time, assignees, and due date, along with the ability to attach files, leave comments, track time, and set dependencies on other tasks. Tasks are organized within task lists, helping structure and sequence work logically. They serve as the building blocks of project management in Teamwork, allowing teams to collaborate, monitor progress, and ensure accountability throughout the project's lifecycle.

ParametersTypeDescription
tasklist_idintegerThe ID of the tasklist from which to retrieve tasks.
assignee_user_idsarrayoptionalA list of user IDs to filter tasks by assigned users
match_all_tagsbooleanoptionalIf true, the search will match tasks that have all the specified tags. If false, the search will match tasks that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter tasks by name.
tag_idsarrayoptionalA list of tag IDs to filter tasks by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_teams

List teams in Teamwork.com. In the context of Teamwork.com, a team is a group of users who are organized together to collaborate more efficiently on projects and tasks. Teams help structure work by grouping individuals with similar roles, responsibilities, or departmental functions, making it easier to assign work, track progress, and manage communication. By using teams, organizations can streamline project planning and ensure the right people are involved in the right parts of a project, enhancing clarity and accountability across the platform.

ParametersTypeDescription
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter teams by name or handle.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_teams_by_company

List teams in Teamwork.com by client/company. In the context of Teamwork.com, a team is a group of users who are organized together to collaborate more efficiently on projects and tasks. Teams help structure work by grouping individuals with similar roles, responsibilities, or departmental functions, making it easier to assign work, track progress, and manage communication. By using teams, organizations can streamline project planning and ensure the right people are involved in the right parts of a project, enhancing clarity and accountability across the platform.

ParametersTypeDescription
company_idintegerThe ID of the company from which to retrieve teams.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter teams by name or handle.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_teams_by_project

List teams in Teamwork.com by project. In the context of Teamwork.com, a team is a group of users who are organized together to collaborate more efficiently on projects and tasks. Teams help structure work by grouping individuals with similar roles, responsibilities, or departmental functions, making it easier to assign work, track progress, and manage communication. By using teams, organizations can streamline project planning and ensure the right people are involved in the right parts of a project, enhancing clarity and accountability across the platform.

ParametersTypeDescription
project_idintegerThe ID of the project from which to retrieve teams.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter teams by name or handle.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_timelogs

List timelogs in Teamwork.com. Timelog refers to a recorded entry that tracks the amount of time a person has spent working on a specific task, project, or piece of work. These entries typically include details such as the duration of time worked, the date and time it was logged, who logged it, and any optional notes describing what was done during that period. Timelogs are essential for understanding how time is being allocated across projects, enabling teams to manage resources more effectively, invoice clients accurately, and assess productivity. They can be created manually or with timers, and are often used for reporting and billing purposes.

ParametersTypeDescription
assigned_company_idsarrayoptionalA list of company IDs to filter timelogs by assigned companies
assigned_team_idsarrayoptionalA list of team IDs to filter timelogs by assigned teams
assigned_user_idsarrayoptionalA list of user IDs to filter timelogs by assigned users
end_datestringoptionalEnd date to filter timelogs. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.
match_all_tagsbooleanoptionalIf true, the search will match timelogs that have all the specified tags. If false, the search will match timelogs that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
start_datestringoptionalStart date to filter timelogs. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.
tag_idsarrayoptionalA list of tag IDs to filter timelogs by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_timelogs_by_project

List timelogs in Teamwork.com by project. Timelog refers to a recorded entry that tracks the amount of time a person has spent working on a specific task, project, or piece of work. These entries typically include details such as the duration of time worked, the date and time it was logged, who logged it, and any optional notes describing what was done during that period. Timelogs are essential for understanding how time is being allocated across projects, enabling teams to manage resources more effectively, invoice clients accurately, and assess productivity. They can be created manually or with timers, and are often used for reporting and billing purposes.

ParametersTypeDescription
project_idintegerThe ID of the project from which to retrieve timelogs.
assigned_company_idsarrayoptionalA list of company IDs to filter timelogs by assigned companies
assigned_team_idsarrayoptionalA list of team IDs to filter timelogs by assigned teams
assigned_user_idsarrayoptionalA list of user IDs to filter timelogs by assigned users
end_datestringoptionalEnd date to filter timelogs. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.
match_all_tagsbooleanoptionalIf true, the search will match timelogs that have all the specified tags. If false, the search will match timelogs that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
start_datestringoptionalStart date to filter timelogs. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.
tag_idsarrayoptionalA list of tag IDs to filter timelogs by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_timelogs_by_task

List timelogs in Teamwork.com by task. Timelog refers to a recorded entry that tracks the amount of time a person has spent working on a specific task, project, or piece of work. These entries typically include details such as the duration of time worked, the date and time it was logged, who logged it, and any optional notes describing what was done during that period. Timelogs are essential for understanding how time is being allocated across projects, enabling teams to manage resources more effectively, invoice clients accurately, and assess productivity. They can be created manually or with timers, and are often used for reporting and billing purposes.

ParametersTypeDescription
task_idintegerThe ID of the task from which to retrieve timelogs.
assigned_company_idsarrayoptionalA list of company IDs to filter timelogs by assigned companies
assigned_team_idsarrayoptionalA list of team IDs to filter timelogs by assigned teams
assigned_user_idsarrayoptionalA list of user IDs to filter timelogs by assigned users
end_datestringoptionalEnd date to filter timelogs. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.
match_all_tagsbooleanoptionalIf true, the search will match timelogs that have all the specified tags. If false, the search will match timelogs that have any of the specified tags. Defaults to false.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
start_datestringoptionalStart date to filter timelogs. The date format follows RFC3339 - YYYY-MM-DDTHH:MM:SSZ.
tag_idsarrayoptionalA list of tag IDs to filter timelogs by tags

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_timers

List timers in Teamwork.com. Timer is a built-in tool that allows users to accurately track the time they spend working on specific tasks, projects, or client work. Instead of manually recording hours, users can start, pause, and stop timers directly within the platform or through the desktop and mobile apps, ensuring precise time logs without interrupting their workflow. Once recorded, these entries are automatically linked to the relevant task or project, making it easier to monitor productivity, manage billable hours, and generate detailed reports for both internal tracking and client invoicing.

ParametersTypeDescription
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
project_idintegeroptionalThe ID of the project to filter timers by. Only timers associated with this project will be returned.
running_timers_onlybooleanoptionalIf true, only running timers will be returned. Defaults to false, which returns all timers.
task_idintegeroptionalThe ID of the task to filter timers by. Only timers associated with this task will be returned.
user_idintegeroptionalThe ID of the user to filter timers by. Only timers associated with this user will be returned.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_users

List users in Teamwork.com. A user is an individual who has access to one or more projects within a Teamwork site, typically as a team member, collaborator, or administrator. Users can be assigned tasks, participate in discussions, log time, share files, and interact with other members depending on their permission levels. Each user has a unique profile that defines their role, visibility, and access to features and project data. Users can belong to clients/companies or teams within the system, and their permissions can be customized to control what actions they can perform or what information they can see.

ParametersTypeDescription
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter users by first or last names, or e-mail. The user will be selected if each word of the term matches the first or last name, or e-mail, not requiring that the word matches are in the same field.
typeintegeroptionalType of user to filter by. The available options are account, collaborator or contact.

This tool is read-only. It does not modify its environment.


Tool: twprojects-list_users_by_project

List users in Teamwork.com by project. A user is an individual who has access to one or more projects within a Teamwork site, typically as a team member, collaborator, or administrator. Users can be assigned tasks, participate in discussions, log time, share files, and interact with other members depending on their permission levels. Each user has a unique profile that defines their role, visibility, and access to features and project data. Users can belong to clients/companies or teams within the system, and their permissions can be customized to control what actions they can perform or what information they can see.

ParametersTypeDescription
project_idintegerThe ID of the project from which to retrieve users.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
search_termstringoptionalA search term to filter users by first or last names, or e-mail. The user will be selected if each word of the term matches the first or last name, or e-mail, not requiring that the word matches are in the same field.
typeintegeroptionalType of user to filter by. The available options are account, collaborator or contact.

This tool is read-only. It does not modify its environment.


Tool: twprojects-pause_timer

Pause an existing timer in Teamwork.com. Timer is a built-in tool that allows users to accurately track the time they spend working on specific tasks, projects, or client work. Instead of manually recording hours, users can start, pause, and stop timers directly within the platform or through the desktop and mobile apps, ensuring precise time logs without interrupting their workflow. Once recorded, these entries are automatically linked to the relevant task or project, making it easier to monitor productivity, manage billable hours, and generate detailed reports for both internal tracking and client invoicing.

ParametersTypeDescription
idintegerThe ID of the timer to pause.

Tool: twprojects-resume_timer

Resume an existing timer in Teamwork.com. Timer is a built-in tool that allows users to accurately track the time they spend working on specific tasks, projects, or client work. Instead of manually recording hours, users can start, pause, and stop timers directly within the platform or through the desktop and mobile apps, ensuring precise time logs without interrupting their workflow. Once recorded, these entries are automatically linked to the relevant task or project, making it easier to monitor productivity, manage billable hours, and generate detailed reports for both internal tracking and client invoicing.

ParametersTypeDescription
idintegerThe ID of the timer to resume.

Tool: twprojects-update_comment

Update an existing comment in Teamwork.com. In the Teamwork.com context, a comment is a way for users to communicate and collaborate directly within tasks, milestones, files, or other project items. Comments allow team members to provide updates, ask questions, give feedback, or share relevant information in a centralized and contextual manner. They support rich text formatting, file attachments, and @mentions to notify specific users or teams, helping keep discussions organized and easily accessible within the project. Comments are visible to all users with access to the item, promoting transparency and keeping everyone aligned.

ParametersTypeDescription
bodystringThe content of the comment. The content can be added as text or HTML.
idintegerThe ID of the comment to update.
content_typestringoptionalThe content type of the comment. It can be either 'TEXT' or 'HTML'.

Tool: twprojects-update_company

Update an existing company in Teamwork.com. In the context of Teamwork.com, a company represents an organization or business entity that can be associated with users, projects, and tasks within the platform, and it is often referred to as a “client.” It serves as a way to group related users and projects under a single organizational umbrella, making it easier to manage permissions, assign responsibilities, and organize work. Companies (or clients) are frequently used to distinguish between internal teams and external collaborators, enabling teams to work efficiently while maintaining clear boundaries around ownership, visibility, and access levels across different projects.

ParametersTypeDescription
idintegerThe ID of the company to update.
address_onestringoptionalThe first line of the address of the company.
address_twostringoptionalThe second line of the address of the company.
citystringoptionalThe city of the company.
country_codestringoptionalThe country code of the company, e.g., 'US' for the United States.
email_onestringoptionalThe primary email address of the company.
email_threestringoptionalThe tertiary email address of the company.
email_twostringoptionalThe secondary email address of the company.
faxstringoptionalThe fax number of the company.
industry_idintegeroptionalThe ID of the industry the company belongs to.
manager_idintegeroptionalThe ID of the user who manages the company.
namestringoptionalThe name of the company.
phonestringoptionalThe phone number of the company.
profilestringoptionalA profile description for the company.
statestringoptionalThe state of the company.
tag_idsarrayoptionalA list of tag IDs to associate with the company.
websitestringoptionalThe website of the company.
zipstringoptionalThe ZIP or postal code of the company.

Tool: twprojects-update_milestone

Update an existing milestone in Teamwork.com. In the context of Teamwork.com, a milestone represents a significant point or goal within a project that marks the completion of a major phase or a key deliverable. It acts as a high-level indicator of progress, helping teams track whether work is advancing according to plan. Milestones are typically used to coordinate efforts across different tasks and task lists, providing a clear deadline or objective that multiple team members or departments can align around. They don't contain individual tasks themselves but serve as checkpoints to ensure the project is moving in the right direction.

ParametersTypeDescription
idintegerThe ID of the milestone to update.
assigneesobjectoptionalAn object containing assignees for the milestone.
descriptionstringoptionalA description of the milestone.
due_datestringoptionalThe due date of the milestone in the format YYYYMMDD. This date will be used in all tasks without a due date related to this milestone.
namestringoptionalThe name of the milestone.
tag_idsarrayoptionalA list of tag IDs to associate with the milestone.
tasklist_idsarrayoptionalA list of tasklist IDs to associate with the milestone.

Tool: twprojects-update_notebook

Update an existing notebook in Teamwork.com. Notebook is a space where teams can create, share, and organize written content in a structured way. It’s commonly used for documenting processes, storing meeting notes, capturing research, or drafting ideas that need to be revisited and refined over time. Unlike quick messages or task comments, notebooks provide a more permanent and organized format that can be easily searched and referenced, helping teams maintain a centralized source of knowledge and ensuring important information remains accessible to everyone who needs it.

ParametersTypeDescription
idintegerThe ID of the notebook to update.
contentsstringoptionalThe contents of the notebook.
descriptionstringoptionalA description of the notebook.
namestringoptionalThe name of the notebook.
tag_idsarrayoptionalA list of tag IDs to associate with the notebook.
typestringoptionalThe type of the notebook. Valid values are 'MARKDOWN' and 'HTML'.

Tool: twprojects-update_project

Update an existing project in Teamwork.com. The project feature in Teamwork.com serves as the central workspace for organizing and managing a specific piece of work or initiative. Each project provides a dedicated area where teams can plan tasks, assign responsibilities, set deadlines, and track progress toward shared goals. Projects include tools for communication, file sharing, milestones, and time tracking, allowing teams to stay aligned and informed throughout the entire lifecycle of the work. Whether it's a product launch, client engagement, or internal initiative, projects in Teamwork.com help teams structure their efforts, collaborate more effectively, and deliver results with greater visibility and accountability.

ParametersTypeDescription
idintegerThe ID of the project to update.
company_idintegeroptionalThe ID of the company associated with the project.
descriptionstringoptionalThe description of the project.
end_atstringoptionalThe end date of the project in the format YYYYMMDD.
namestringoptionalThe name of the project.
owned_idintegeroptionalThe ID of the user who owns the project.
start_atstringoptionalThe start date of the project in the format YYYYMMDD.
tag_idsarrayoptionalA list of tag IDs to associate with the project.

Tool: twprojects-update_tag

Update an existing tag in Teamwork.com. In the context of Teamwork.com, a tag is a customizable label that can be applied to various items such as tasks, projects, milestones, messages, and more, to help categorize and organize work efficiently. Tags provide a flexible way to filter, search, and group related items across the platform, making it easier for teams to manage complex workflows, highlight priorities, or track themes and statuses. Since tags are user-defined, they adapt to each team’s specific needs and can be color-coded for better visual clarity.

ParametersTypeDescription
idintegerThe ID of the tag to update.
namestringoptionalThe name of the tag. It must have less than 50 characters.
project_idintegeroptionalThe ID of the project to associate the tag with. This is for project-scoped tags.

Tool: twprojects-update_task

Update an existing task in Teamwork.com. In Teamwork.com, a task represents an individual unit of work assigned to one or more team members within a project. Each task can include details such as a title, description, priority, estimated time, assignees, and due date, along with the ability to attach files, leave comments, track time, and set dependencies on other tasks. Tasks are organized within task lists, helping structure and sequence work logically. They serve as the building blocks of project management in Teamwork, allowing teams to collaborate, monitor progress, and ensure accountability throughout the project's lifecycle.

ParametersTypeDescription
idintegerThe ID of the task to update.
assigneesobjectoptionalAn object containing assignees for the task.
descriptionstringoptionalThe description of the task.
due_datestringoptionalThe due date of the task in ISO 8601 format (YYYY-MM-DD). When this is not provided, it will fallback to the milestone due date if a milestone is set.
estimated_minutesintegeroptionalThe estimated time to complete the task in minutes.
parent_task_idintegeroptionalThe ID of the parent task if creating a subtask.
predecessorsarrayoptionalList of task dependencies that must be completed before this task can start, defining its position in the project workflow and ensuring proper sequencing of work.
prioritystringoptionalThe priority of the task. Possible values are: low, medium, high.
progressintegeroptionalThe progress of the task, as a percentage (0-100). Only whole numbers are allowed.
start_datestringoptionalThe start date of the task in ISO 8601 format (YYYY-MM-DD).
tag_idsarrayoptionalA list of tag IDs to assign to the task.
tasklist_idintegeroptionalThe ID of the tasklist.

Tool: twprojects-update_tasklist

Update an existing tasklist in Teamwork.com. In the context of Teamwork.com, a task list is a way to group related tasks within a project, helping teams organize their work into meaningful sections such as phases, categories, or deliverables. Each task list belongs to a specific project and can include multiple tasks that are typically aligned with a common goal. Task lists can be associated with milestones, and they support privacy settings that control who can view or interact with the tasks they contain. This structure helps teams manage progress, assign responsibilities, and maintain clarity across complex projects.

ParametersTypeDescription
idintegerThe ID of the tasklist to update.
descriptionstringoptionalThe description of the tasklist.
milestone_idintegeroptionalThe ID of the milestone to associate with the tasklist.
namestringoptionalThe name of the tasklist.

Tool: twprojects-update_team

Update an existing team in Teamwork.com. In the context of Teamwork.com, a team is a group of users who are organized together to collaborate more efficiently on projects and tasks. Teams help structure work by grouping individuals with similar roles, responsibilities, or departmental functions, making it easier to assign work, track progress, and manage communication. By using teams, organizations can streamline project planning and ensure the right people are involved in the right parts of a project, enhancing clarity and accountability across the platform.

ParametersTypeDescription
idintegerThe ID of the team to update.
company_idintegeroptionalThe ID of the company. This is used to create a team scoped for a specific company.
descriptionstringoptionalThe description of the team.
handlestringoptionalThe handle of the team. It is a unique identifier for the team. It must not have spaces or special characters.
namestringoptionalThe name of the team.
parent_team_idintegeroptionalThe ID of the parent team. This is used to create a hierarchy of teams.
project_idintegeroptionalThe ID of the project. This is used to create a team scoped for a specific project.
user_idsarrayoptionalA list of user IDs to add to the team.

Tool: twprojects-update_timelog

Update an existing timelog in Teamwork.com. Timelog refers to a recorded entry that tracks the amount of time a person has spent working on a specific task, project, or piece of work. These entries typically include details such as the duration of time worked, the date and time it was logged, who logged it, and any optional notes describing what was done during that period. Timelogs are essential for understanding how time is being allocated across projects, enabling teams to manage resources more effectively, invoice clients accurately, and assess productivity. They can be created manually or with timers, and are often used for reporting and billing purposes.

ParametersTypeDescription
idintegerThe ID of the timelog to update.
billablebooleanoptionalIf true, the timelog is billable. Defaults to false.
datestringoptionalThe date of the timelog in the format YYYY-MM-DD.
descriptionstringoptionalA description of the timelog.
hoursintegeroptionalThe number of hours spent on the timelog. Must be a positive integer.
is_utcbooleanoptionalIf true, the time is in UTC. Defaults to false.
minutesintegeroptionalThe number of minutes spent on the timelog. Must be a positive integer less than 60, otherwise the hours attribute should be incremented.
project_idintegeroptionalThe ID of the project to associate the timelog with. Either project_id or task_id must be provided, but not both.
tag_idsarrayoptionalA list of tag IDs to associate with the timelog.
task_idintegeroptionalThe ID of the task to associate the timelog with. Either project_id or task_id must be provided, but not both.
timestringoptionalThe time of the timelog in the format HH:MM:SS.
user_idintegeroptionalThe ID of the user to associate the timelog with. Defaults to the authenticated user if not provided.

Tool: twprojects-update_timer

Update an existing timer in Teamwork.com. Timer is a built-in tool that allows users to accurately track the time they spend working on specific tasks, projects, or client work. Instead of manually recording hours, users can start, pause, and stop timers directly within the platform or through the desktop and mobile apps, ensuring precise time logs without interrupting their workflow. Once recorded, these entries are automatically linked to the relevant task or project, making it easier to monitor productivity, manage billable hours, and generate detailed reports for both internal tracking and client invoicing.

ParametersTypeDescription
idintegerThe ID of the timer to update.
billablebooleanoptionalIf true, the timer is billable.
descriptionstringoptionalA description of the timer.
project_idintegeroptionalThe ID of the project to associate the timer with.
runningbooleanoptionalIf true, the timer will start running immediately.
task_idintegeroptionalThe ID of the task to associate the timer with.

Tool: twprojects-update_user

Update an existing user in Teamwork.com. A user is an individual who has access to one or more projects within a Teamwork site, typically as a team member, collaborator, or administrator. Users can be assigned tasks, participate in discussions, log time, share files, and interact with other members depending on their permission levels. Each user has a unique profile that defines their role, visibility, and access to features and project data. Users can belong to clients/companies or teams within the system, and their permissions can be customized to control what actions they can perform or what information they can see.

ParametersTypeDescription
idintegerThe ID of the user to update.
adminbooleanoptionalIndicates whether the user is an administrator.
company_idintegeroptionalThe ID of the client/company to which the user belongs.
emailstringoptionalThe email address of the user.
first_namestringoptionalThe first name of the user.
last_namestringoptionalThe last name of the user.
titlestringoptionalThe job title of the user, such as 'Project Manager' or 'Senior Software Developer'.
typestringoptionalThe type of user, such as 'account', 'collaborator', or 'contact'.

Tool: twprojects-users_workload

Get the workload of users in Teamwork.com. Workload is a visual representation of how tasks are distributed across team members, helping you understand who is overloaded, who has capacity, and how work is balanced within a project or across multiple projects. It takes into account assigned tasks, due dates, estimated time, and working hours to give managers and teams a clear picture of availability and resource allocation. By providing this insight, workload makes it easier to plan effectively, prevent burnout, and ensure that deadlines are met without placing too much pressure on any single person.

ParametersTypeDescription
end_datestringThe end date of the workload period. The date must be in the format YYYY-MM-DD.
start_datestringThe start date of the workload period. The date must be in the format YYYY-MM-DD.
pageintegeroptionalPage number for pagination of results.
page_sizeintegeroptionalNumber of results per page for pagination.
project_idsarrayoptionalList of project IDs to filter the workload by.
user_company_idsarrayoptionalList of users' client/company IDs to filter the workload by.
user_idsarrayoptionalList of user IDs to filter the workload by.
user_team_idsarrayoptionalList of users' team IDs to filter the workload by.

This tool is read-only. It does not modify its environment.


Use this MCP Server

{
  "mcpServers": {
    "teamwork": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TW_MCP_BEARER_TOKEN",
        "mcp/teamwork"
      ],
      "env": {
        "TW_MCP_BEARER_TOKEN": "<TW_MCP_BEARER_TOKEN>"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?

Manual installation

You can install the MCP server using:

Installation for

Related servers