> This page is for Agent Handler. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.merge.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server. # Teamwork.com **Authentication:** API key authentication. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow. ## Sample use cases * Show me every task assigned to me, sorted by due date. * Move all tasks in the `Q2 Roadmap` project past their due date into `Late`. * Pull the status breakdown for tasks in the `Client Onboarding` project. ## Available Tools #### list\_comments List all comments on a specific resource (task, milestone, file, or notebook). Returns comments with their details including body content, author, and timestamps. #### create\_comment Add a new comment to a resource (task, milestone, file, or notebook). Allows specifying the comment body and optionally notifying specific users. #### update\_comment Update an existing comment's body content. The comment body is the only field that can be updated. #### delete\_comment Permanently delete a comment from a resource. This action cannot be undone. #### list\_companies List all companies (clients) in the Teamwork.com workspace with optional search filtering. #### get\_company Get detailed information about a specific company by its ID. Returns full company details including name, address, contact information, website, and associated people/project counts. #### create\_company Create a new company (client) in the Teamwork.com workspace. Allows setting name, address, contact information, and website. Companies can be associated with projects and people. #### update\_company Update an existing company's properties including name, phone, and website. Only provided fields will be updated. #### delete\_company Permanently delete a company from the Teamwork.com workspace. This action cannot be undone. Associated projects will not be deleted but will lose their company association. #### list\_milestones List milestones in the Teamwork.com workspace with optional filtering by project. Returns milestones with their details including name, description, deadline, status, and responsible parties. #### get\_milestone Get detailed information about a specific milestone by its ID. Returns full milestone details including name, description, deadline, status, responsible parties, and associated task counts. #### create\_milestone Create a new milestone within a project. Milestones represent key deadlines or deliverables. Allows setting name, deadline, description, and responsible parties. #### update\_milestone Update an existing milestone's properties including name, deadline, and description. Only provided fields will be updated. #### delete\_milestone Permanently delete a milestone from the Teamwork.com workspace. This action cannot be undone. Associated tasks will not be deleted but will lose their milestone association. #### complete\_milestone Mark a milestone as complete. This will set the milestone status to completed and record the completion timestamp. #### uncomplete\_milestone Reopen a completed milestone by marking it as incomplete. This will restore the milestone to active status. #### list\_people List all people (users) in the Teamwork.com workspace with optional search filtering. Returns people with their details including name, email, title, phone numbers, and company association. #### get\_person Get detailed information about a specific person by their ID. Returns full person details including name, email, title, phone numbers, company association, and user type information. #### get\_current\_user Get detailed information about the currently authenticated user. Useful for identifying the user associated with the API key being used. #### list\_projects List all projects in the Teamwork.com workspace with filtering, pagination, and status support. #### get\_project Get detailed information about a specific project by its ID. Returns full project details including name, description, status, dates, company association, tags, and other metadata. #### create\_project Create a new project in the Teamwork.com workspace. Allows setting name, description, company association, category, start/end dates, and tags. #### update\_project Update an existing project's properties including name, description, status, and dates. Only provided fields will be updated. #### delete\_project Permanently delete a project from the Teamwork.com workspace. This action cannot be undone and will delete all associated tasks, task lists, and other project data. #### list\_tags List all tags in the Teamwork.com workspace. Returns tags with their details including name and color. Tags can be used to categorize and filter projects, tasks, and other resources. #### get\_tag Get detailed information about a specific tag by its ID. Returns full tag details including name, color, and associated project information. #### create\_tag Create a new tag in the Teamwork.com workspace. Tags can be used to categorize projects, tasks, and other resources. Allows setting name and optional color. #### update\_tag Update an existing tag's name or color. Only provided fields will be updated. #### delete\_tag Permanently delete a tag from the Teamwork.com workspace. This action cannot be undone. Resources that had this tag will lose their tag association. #### list\_tasks List tasks in the Teamwork.com workspace with extensive filtering options. #### get\_task Get detailed information about a specific task by its ID. Returns full task details including name, description, priority, dates, assignees, progress, dependencies, and tags. #### create\_task Create a new task within a task list. Allows setting name, description, priority, dates, assignees, time estimates, and tags. Tasks must be created within an existing task list. #### update\_task Update an existing task's properties including name, description, priority, dates, assignees, and progress. Only provided fields will be updated. #### delete\_task Permanently delete a task from the Teamwork.com workspace. This action cannot be undone and will also delete any subtasks. #### complete\_task Mark a task as complete. This will set the task status to completed and record the completion timestamp. #### uncomplete\_task Reopen a completed task by marking it as incomplete. This will restore the task to active status. #### list\_tasklists List all task lists within a specific project. Returns task lists with their details including name, description, task counts, and position order. #### get\_tasklist Get detailed information about a specific task list by its ID. Returns full task list details including name, description, task counts, and associated project information. #### create\_tasklist Create a new task list within a project. Task lists help organize tasks into logical groups and can have descriptions. #### update\_tasklist Update an existing task list's name or description. Only provided fields will be updated. #### delete\_tasklist Permanently delete a task list from a project. This action cannot be undone and may also delete all tasks within the list. #### list\_time\_entries List time entries in the Teamwork.com workspace with filtering options. #### get\_time\_entry Get detailed information about a specific time entry by its ID. Returns full time entry details including hours, minutes, date, description, billable status, and associated task/project information. #### create\_time\_entry Log time against a task. Create a new time entry with hours, minutes, date, optional description, and billable status. Time entries are used to track work hours for tasks and projects. #### update\_time\_entry Update an existing time entry's properties including hours, minutes, date, description, and billable status. Only provided fields will be updated. #### delete\_time\_entry Permanently delete a time entry from the Teamwork.com workspace. This action cannot be undone.