Teamwork MCP server
220 operations0 webhooks
Teamwork.com projects, tasks, task lists, milestones, comments, time tracking, timers, people and companies.
Try Teamwork with your agent
Connect Teamwork, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Teamwork on my account, then run one read-only example and show me the result.
Teamwork tools and triggers
Tools are what your agent can do in Teamwork through Corsair's MCP server. Triggers are the Teamwork events a routine can start from.
Tasks
- CompleteWrite
Mark a task complete.
tasks.complete
- CopyWrite
Copy a task to another project or task list.
tasks.copy
- Count CompletedRead-only
Count completed tasks.
tasks.countCompleted
- Count LateRead-only
Count late tasks.
tasks.countLate
- CreateWrite
Create a task in a task list.
tasks.create
- Create SubtaskWrite
Create a subtask under a task.
tasks.createSubtask
- DeleteDestructive
Delete a task (it goes to the trash).
tasks.delete
- GetRead-only
Get one task.
tasks.get
- ListRead-only
List tasks. Filter with projectIds, tasklistIds, parentTaskId, responsiblePartyIds, tagIds, completedOnly/includeCompletedTasks, due dates and more.
tasks.list
- List DependenciesRead-only
List the tasks that depend on a task.
tasks.listDependencies
- List PredecessorsRead-only
List the tasks a task waits on.
tasks.listPredecessors
- List RecurringRead-only
List the repeats of a recurring task.
tasks.listRecurring
- MoveWrite
Move a task to another project or task list.
tasks.move
- Quick AddWrite
Add several tasks to a project at once from lines of text.
tasks.quickAdd
- Quick Add SubtasksWrite
Add several subtasks to a task at once from lines of text.
tasks.quickAddSubtasks
- ReorderWrite
Reorder the tasks in a task list.
tasks.reorder
- Set EstimateWrite
Set a task's time estimate.
tasks.setEstimate
- Time ReportRead-only
Report of time logged against tasks.
tasks.timeReport
- UncompleteWrite
Reopen a completed task.
tasks.uncomplete
- UpdateWrite
Update a task (only the fields you send change).
tasks.update
Time
- By CompanyRead-only
Time entries grouped by company.
time.byCompany
- CreateWrite
Log time on a project.
time.create
- Create For TaskWrite
Log time on a task.
time.createForTask
- DeleteDestructive
Delete a time entry.
time.delete
- Estimated TotalsRead-only
Estimated time totals per project.
time.estimatedTotals
- GetRead-only
Get one time entry.
time.get
- ListRead-only
List time entries. Filter with projectIds, taskIds, tasklistIds, assignedToUserIds, startDate/endDate and more.
time.list
- Logged By PersonRead-only
Time a person logged, by day.
time.loggedByPerson
- ReportRead-only
Time report for a date range (startDate and endDate required).
time.report
- Report By TypeRead-only
Time report grouped by user, project, company or task.
time.reportByType
- Report TotalsRead-only
Time report totals for a date range.
time.reportTotals
- TotalsRead-only
Total logged time. Filter with projectIds, tasklistIds, taskIds, userIds.
time.totals
- UpdateWrite
Update a time entry (only the fields you send change).
time.update
- ValidateRead-only
Check whether a time entry can be logged (needs time approvals on the plan).
time.validate
Projects
- CloneWrite
Copy a project, optionally with its tasks, milestones and people.
projects.clone
- Convert TentativeWrite
Convert a tentative project into a normal project.
projects.convertTentative
- CreateWrite
Create a project.
projects.create
- DeleteDestructive
Delete a project.
projects.delete
- GetRead-only
Get one project by id.
projects.get
- Get RatesRead-only
Get a project's billable rates per user.
projects.getRates
- Get StatsRead-only
Get task and milestone counts for a project.
projects.getStats
- ListRead-only
List projects. Filter with projectIds, projectCompanyIds, projectCategoryIds, projectStatuses, searchTerm and more.
projects.list
- List StarredRead-only
List the projects the current user has starred.
projects.listStarred
- List Task PredecessorsRead-only
List every task dependency (predecessor) in a project.
projects.listTaskPredecessors
- Set RatesWrite
Set a project's billable rates.
projects.setRates
- StarWrite
Star a project for the current user.
projects.star
- UpdateWrite
Update a project's name, dates, owner, category or settings.
projects.update
Notebooks
- CopyWrite
Copy a notebook to another project.
notebooks.copy
- CreateWrite
Create a notebook in a project.
notebooks.create
- DeleteDestructive
Delete a notebook.
notebooks.delete
- Delete VersionsDestructive
Delete notebook versions.
notebooks.deleteVersions
- GetRead-only
Get one notebook with its contents.
notebooks.get
- Get VersionRead-only
Get one version of a notebook.
notebooks.getVersion
- ListRead-only
List notebooks. Filter with projectIds, categoryIds, tagIds.
notebooks.list
- List VersionsRead-only
List a notebook's versions.
notebooks.listVersions
- LockWrite
Lock a notebook for editing.
notebooks.lock
- MoveWrite
Move a notebook to another project.
notebooks.move
- UnlockWrite
Unlock a notebook.
notebooks.unlock
- UpdateWrite
Update a notebook.
notebooks.update
People
- Add To ProjectsWrite
Add one user to many projects at once.
people.addToProjects
- CreateDestructive
Add a user to the site. Teamwork emails them an invitation unless sendInvite is false.
people.create
- DeleteDestructive
Delete a user.
people.delete
- GetRead-only
Get one person.
people.get
- ListRead-only
List people. Filter with projectIds, companyIds, teamIds, searchTerm and more.
people.list
- List DeletedRead-only
List deleted users.
people.listDeleted
- MeRead-only
Get the user the API key belongs to.
people.me
- My StatsRead-only
Summary counts for the current user (tasks, milestones, messages).
people.myStats
- PerformanceRead-only
The users who completed the most tasks.
people.performance
- Task CompletionRead-only
Task completions per user.
people.taskCompletion
- UpdateWrite
Update a user.
people.update
- UtilizationRead-only
User utilization for a date range.
people.utilization
Teams
- CreateWrite
Create a team.
teams.create
- Create For ProjectWrite
Create a project-specific team.
teams.createForProject
- DeleteDestructive
Delete a team.
teams.delete
- GetRead-only
Get one team.
teams.get
- ListRead-only
List teams.
teams.list
- List For CompanyRead-only
List a company's teams.
teams.listForCompany
- List For PersonRead-only
List the teams a person is in.
teams.listForPerson
- List For ProjectRead-only
List the teams on a project.
teams.listForProject
- List Member IdsRead-only
The user ids in every team.
teams.listMemberIds
- List SubteamsRead-only
List a team's subteams.
teams.listSubteams
- Set MembersDestructive
Add members to a team, or replace all of them (action defaults to replace).
teams.setMembers
- UpdateWrite
Update a team.
teams.update
Companies
- Add DomainsWrite
Add email domains to a company.
companies.addDomains
- Convert CurrencyDestructive
Convert a company's currency, rewriting its rates and budgets.
companies.convertCurrency
- CreateWrite
Create a company.
companies.create
- DeleteDestructive
Delete a company.
companies.delete
- Delete DomainDestructive
Delete a company email domain.
companies.deleteDomain
- GetRead-only
Get one company.
companies.get
- ListRead-only
List companies.
companies.list
- List For ProjectRead-only
List the companies on a project.
companies.listForProject
- Set RatesWrite
Set a company's client rates per role.
companies.setRates
- UpdateWrite
Update a company.
companies.update
- Update DomainWrite
Update a company email domain.
companies.updateDomain
Timers
- CompleteWrite
Stop a timer and log its time.
timers.complete
- CreateWrite
Start a timer.
timers.create
- DeleteDestructive
Delete a timer.
timers.delete
- GetRead-only
Get one timer.
timers.get
- ListRead-only
List running timers. Filter with userId, projectId, taskId.
timers.list
- List MineRead-only
List the current user's timers.
timers.listMine
- PauseWrite
Pause a timer.
timers.pause
- ResumeWrite
Resume a paused timer.
timers.resume
- UndeleteWrite
Restore a deleted timer.
timers.undelete
- UpdateWrite
Edit a timer.
timers.update
Tasklists
- CopyWrite
Copy a task list, within its project or to another.
tasklists.copy
- CreateWrite
Create a task list in a project.
tasklists.create
- DeleteDestructive
Delete a task list and its tasks.
tasklists.delete
- GetRead-only
Get one task list.
tasklists.get
- ListRead-only
List task lists. Filter with projectIds.
tasklists.list
- List TemplatesRead-only
List task list templates.
tasklists.listTemplates
- MoveWrite
Move a task list to another project.
tasklists.move
- ReorderWrite
Reorder the task lists in a project.
tasklists.reorder
- UpdateWrite
Update a task list.
tasklists.update
Files
- Add To ProjectWrite
Attach an uploaded file (pendingFileRef) to a project.
files.addToProject
- Add To TaskWrite
Attach an uploaded file (pendingFileRef) to a task.
files.addToTask
- Add VersionWrite
Add a new version to a file.
files.addVersion
- CopyWrite
Copy a file to another project.
files.copy
- DeleteDestructive
Delete a file.
files.delete
- Get Share LinkRead-only
Get a short share link for a file.
files.getShareLink
- List For ProjectRead-only
List the files on a project.
files.listForProject
- List For TaskRead-only
List the files on a task.
files.listForTask
Milestones
- CompleteWrite
Mark a milestone complete.
milestones.complete
- CreateWrite
Create a milestone in a project.
milestones.create
- DeleteDestructive
Delete a milestone (it goes to the trash).
milestones.delete
- GetRead-only
Get one milestone.
milestones.get
- ListRead-only
List milestones. Filter with projectIds, assignedToUserIds, tagIds and more.
milestones.list
- List By DeadlineRead-only
List milestones due in a date range.
milestones.listByDeadline
- UncompleteWrite
Reopen a completed milestone.
milestones.uncomplete
- UpdateWrite
Update a milestone.
milestones.update
Comments
- CreateWrite
Comment on a task, milestone, file, notebook or link. Teamwork notifies the people in notify.
comments.create
- DeleteDestructive
Delete a comment.
comments.delete
- GetRead-only
Get one comment.
comments.get
- ListRead-only
List comments across tasks, milestones, files, notebooks and links. Filter with objectIds, projectIds, userIds.
comments.list
- List NotifiedRead-only
List the users notified about a comment.
comments.listNotified
- Mark ReadWrite
Mark a comment as read.
comments.markRead
- UpdateWrite
Edit a comment.
comments.update
Statuses
- CreateWrite
Set a person's status.
statuses.create
- DeleteDestructive
Delete a status by id.
statuses.delete
- Get For PersonRead-only
Get a person's status.
statuses.getForPerson
- Get MineRead-only
Get the current user's status.
statuses.getMine
- ListRead-only
List everyone's current status.
statuses.list
- TimelineRead-only
The people status timeline.
statuses.timeline
- UpdateWrite
Update a status by id.
statuses.update
Links
- CreateWrite
Add a link to a project.
links.create
- DeleteDestructive
Delete a link.
links.delete
- GetRead-only
Get one link.
links.get
- ListRead-only
List links across all projects.
links.list
- List For ProjectRead-only
List the links on a project.
links.listForProject
- UpdateWrite
Update a link.
links.update
Board Cards
- DeleteDestructive
Remove a card from the board.
boardCards.delete
- GetRead-only
Get one board card.
boardCards.get
- ListRead-only
List the cards in a board column.
boardCards.list
- MoveWrite
Move a card to another column.
boardCards.move
- UpdateWrite
Update a board card.
boardCards.update
Board Columns
- CreateWrite
Create a board column.
boardColumns.create
- DeleteDestructive
Delete a board column.
boardColumns.delete
- GetRead-only
Get one board column.
boardColumns.get
- ListRead-only
List the board columns of a project (needs Boards on for the project).
boardColumns.list
- UpdateWrite
Update a board column.
boardColumns.update
File Categories
- CreateWrite
Create a file category.
fileCategories.create
- DeleteDestructive
Delete a file category.
fileCategories.delete
- GetRead-only
Get one file category.
fileCategories.get
- ListRead-only
List a project's file categories.
fileCategories.list
- UpdateWrite
Update a file category.
fileCategories.update
Notebook Categories
- CreateWrite
Create a notebook category.
notebookCategories.create
- DeleteDestructive
Delete a notebook category.
notebookCategories.delete
- GetRead-only
Get one notebook category.
notebookCategories.get
- ListRead-only
List a project's notebook categories.
notebookCategories.list
- UpdateWrite
Update a notebook category.
notebookCategories.update
Portfolio Cards
- AddWrite
Add a project to a portfolio column.
portfolioCards.add
- DeleteDestructive
Remove a project card from a portfolio column.
portfolioCards.delete
- GetRead-only
Get one portfolio card.
portfolioCards.get
- ListRead-only
List the project cards in a portfolio column.
portfolioCards.list
- MoveWrite
Move a project card to another column.
portfolioCards.move
Project Categories
- CreateWrite
Create a project category.
projectCategories.create
- DeleteDestructive
Delete a project category.
projectCategories.delete
- GetRead-only
Get one project category.
projectCategories.get
- ListRead-only
List project categories.
projectCategories.list
- UpdateWrite
Rename or move a project category.
projectCategories.update
Project People
- AddWrite
Add people to a project.
projectPeople.add
- GetRead-only
Get one person's membership on a project.
projectPeople.get
- Get PermissionsRead-only
Get a person's permissions on a project.
projectPeople.getPermissions
- ListRead-only
List the people on a project.
projectPeople.list
- RemoveDestructive
Remove a person from a project.
projectPeople.remove
Project Updates
- CreateDestructive
Post a status update on a project. Notifies the people in notifyIds.
projectUpdates.create
- DeleteDestructive
Delete a project update.
projectUpdates.delete
- ListRead-only
List project status updates. Filter with projectIds.
projectUpdates.list
- RequestDestructive
Ask the project owner for a status update. Notifies the owner.
projectUpdates.request
- UpdateDestructive
Edit a project update.
projectUpdates.update
Link Categories
- CreateWrite
Create a link category.
linkCategories.create
- DeleteDestructive
Delete a link category.
linkCategories.delete
- GetRead-only
Get one link category.
linkCategories.get
- ListRead-only
List a project's link categories.
linkCategories.list
Portfolio Boards
- CreateWrite
Create a portfolio board.
portfolioBoards.create
- DeleteDestructive
Delete a portfolio board.
portfolioBoards.delete
- ListRead-only
List portfolio boards.
portfolioBoards.list
- UpdateWrite
Update a portfolio board.
portfolioBoards.update
Portfolio Columns
- CreateWrite
Add a column to a portfolio board.
portfolioColumns.create
- DeleteDestructive
Delete a portfolio column.
portfolioColumns.delete
- GetRead-only
Get one portfolio column.
portfolioColumns.get
- ListRead-only
List the columns of a portfolio board.
portfolioColumns.list
Project Metrics
- BillableRead-only
Total billable time per project.
projectMetrics.billable
- HealthRead-only
Health summary across projects.
projectMetrics.health
- InvoicesRead-only
Open invoices across projects.
projectMetrics.invoices
- UnbilledRead-only
Unbilled expenses across projects.
projectMetrics.unbilled
Project Roles
- DeleteDestructive
Delete a project role.
projectRoles.delete
- GetRead-only
Get one project role.
projectRoles.get
- ListRead-only
List the roles on a project.
projectRoles.list
- UpdateWrite
Update a project role.
projectRoles.update
Project Templates
- CreateWrite
Create a project template.
projectTemplates.create
- GetRead-only
Get one project template.
projectTemplates.get
- ListRead-only
List project templates.
projectTemplates.list
- List Required Custom FieldsRead-only
List the custom fields a template requires when a project is made from it.
projectTemplates.listRequiredCustomFields
Task Reminders
- CreateDestructive
Add a reminder to a task. Teamwork emails or messages the people it names when it fires.
taskReminders.create
- DeleteDestructive
Delete a task reminder.
taskReminders.delete
- ListRead-only
List the reminders on a task.
taskReminders.list
- UpdateWrite
Change a reminder's time, type or note. To change who gets it, delete it and add a new one.
taskReminders.update
Personal Tasks
- CreateWrite
Create a personal task.
personalTasks.create
- GetRead-only
Get one personal task.
personalTasks.get
- ListRead-only
List the current user's personal tasks.
personalTasks.list
Connect Teamwork to Claude, ChatGPT or Cursor
- 1
Connect Teamwork in Corsair
Add your Teamwork API key once in Corsair. Corsair stores the credential encrypted and makes the Teamwork API calls for your agent, so it never goes into a prompt or a config file. Connect Teamwork
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Teamwork. On a ChatGPT personal plan, connect Teamwork here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Teamwork's read and write operations run right away and its 36 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/teamwork, add the Teamwork plugin, and connect with an API key. Then call methods like corsair.teamwork.api.boardCards.delete() from your app. Corsair keeps each tenant isolated.
Yes. Teamwork requires an API key from your Teamwork account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Teamwork, GitHub, Notion, Stripe, and the rest. Trigger Teamwork from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for Teamwork.com projects, tasks, task lists, milestones, comments, time tracking, timers, people and companies. Common builds include sync jobs, admin tooling, and agents that call Teamwork APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Teamwork API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/teamwork in the open repo. When Teamwork ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Teamwork data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Teamwork data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Teamwork on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 36 destructive Teamwork operations. You can change a link's mode at hub.corsair.dev/me.