
MCP server to connect to the Teamwork API
概览
An MCP server that connects to the Teamwork API, providing a simplified interface for interacting with Teamwork projects and tasks. - Connect to Teamwork API - Retrieve projects and tasks - Create, update, and delete tasks - RESTful API endpoints - Error handling and logging - MCP server for integration with Cursor and other applications - Node.js (v14.17 or higher, recommend 18+ or even better latest LTS version) - npm or yarn - Teamwork account with API access The following tools are available through the MCP server: - getProjects - Get all projects from Teamwork - getCurrentProject - Gets details about the current project - createProject - Create a new project in Teamwork - getTasks - Get all tasks from Teamwork - getTasksByProjectId - Get all tasks from a specific project in Teamwork - getTaskListsByProjectId - Get all task lists from a specific project in Teamwork - getTasksByTaskListId - Gets all tasks from a specific task list ID from Teamwork - getTaskById - Get a...
README
以下为原文 README 节选,完整内容请查看原文。
Teamwork MCP
An MCP server that connects to the Teamwork API, providing a simplified interface for interacting with Teamwork projects and tasks.
Features
- Connect to Teamwork API
- Retrieve projects and tasks
- Create, update, and delete tasks
- RESTful API endpoints
- Error handling and logging
- MCP server for integration with Cursor and other applications
Prerequisites
- Node.js (v14.17 or higher, recommend 18+ or even better latest LTS version)
- npm or yarn
- Teamwork account with API access
Available Teamwork MCP Tools
The following tools are available through the MCP server:
Project Tools
getProjects- Get all projects from TeamworkgetCurrentProject- Gets details about the current projectcreateProject- Create a new project in Teamwork
Task Tools
getTasks- Get all tasks from TeamworkgetTasksByProjectId- Get all tasks from a specific project in TeamworkgetTaskListsByProjectId- Get all task lists from a specific project in TeamworkgetTasksByTaskListId- Gets all tasks from a specific task list ID from TeamworkgetTaskById- Get a specific task by ID from TeamworkcreateTask- Create a new task in TeamworkcreateSubTask- Create a new subtask under a parent task in TeamworkupdateTask- Update an existing task in TeamworkdeleteTask- Delete a task from TeamworkgetTasksMetricsComplete- Get the total count of completed tasks in TeamworkgetTasksMetricsLate- Get the total count of late tasks in TeamworkgetTaskSubtasks- Get all subtasks for a specific task in TeamworkgetTaskComments- Get comments for a specific task from Teamwork
Comment Tools
createComment- Create a comment related to a task/message/notebook
Company Tools
getCompanies- Get all companies from Teamwork with optional filteringgetCompanyById- Get a specific company by IDcreateCompany- Create a new company in TeamworkupdateCompany- Update an existing company’s informationdeleteCompany- Delete a company from Teamwork
People Tools
getPeople- Get all people from TeamworkgetPersonById- Get a specific person by ID from TeamworkgetProjectPeople- Get all people assigned to a specific project from TeamworkaddPeopleToProject- Add people to a specific project in TeamworkdeletePerson- Delete a person from TeamworkupdatePerson- Update a person’s information (timezone, name, email, etc.)getProjectsPeopleMetricsPerformance- Get people metrics performancegetProjectsPeopleUtilization- Get people utilizationgetProjectPerson- Get a specific person on a project
Reporting Tools
getProjectsReportingUserTaskCompletion- Get user task completion report
安装
npx -y @vizioz/teamwork-mcp --domain yourdomain --user [email protected] --pass yourPassword配置
{
"mcpServers": {
"teamwork": {
"command": "npx",
"args": [
"-y",
"@vizioz/teamwork-mcp",
"--domain",
"yourdomain",
"--user",
"[email protected]",
"--pass",
"yourPassword"
]
}
}
}