home / mcp / teamwork mcp server

Teamwork MCP Server

MCP server to connect to the Teamwork API

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "vizioz-teamwork-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@vizioz/teamwork-mcp",
        "--domain",
        "your-domain",
        "--user",
        "[email protected]",
        "--pass",
        "your-password"
      ]
    }
  }
}

Teamwork MCP is a server you run locally or in your environment to connect to the Teamwork API. It exposes a set of RESTful endpoints via an MCP interface, letting you manage Teamwork projects, tasks, people, companies, time entries, and more from your dashboards and automation tools.

How to use

You connect to the Teamwork MCP server from your MCP client (such as Cursor, Claude Desktop, Windsurf) using the standard MCP connection flow. Start the server with the provided command, then configure your client to point at the local or remote MCP endpoint. Once connected, you can retrieve data, create or modify tasks and projects, add comments, report on time, and pull metrics. Use credential and domain options to authenticate, then apply tool filtering if you only want a subset of tools exposed to your client.

How to install

Prerequisites you need before installing: a modern Node.js runtime (v14.17 or higher; v18+ or the latest LTS is recommended), and npm or yarn.

Install and run using NPX (recommended):

npx @vizioz/teamwork-mcp
```

You can pass credentials and domain directly when starting the server, for example:

```bash
npx @vizioz/teamwork-mcp --domain=your-company [email protected] --pass=your-password

Additional important content

Configuration for credentials can be provided in three ways: environment variables, a .env file, or command line arguments. The server can also log to a logs directory by default, with separate error and combined log files. Logging can be disabled via command line switches. You can filter which tools are exposed at startup by using allow/deny options, including grouping tools into Projects, Tasks, People, Reporting, Time, and Comments.

To add this MCP server to your client, use the command line form shown above and include domain, user, and password. If you are integrating with Cursor or Claude Desktop, you provide the same base command and arguments in their MCP configuration files. You can also enable or disable logging globally for debugging and auditing purposes.

Available tools

getProjects

Retrieve all projects from Teamwork.

getCurrentProject

Get details about the current project.

createProject

Create a new project in Teamwork.

getTasks

Get all tasks from Teamwork.

getTasksByProjectId

Get all tasks for a specific project.

getTasksByTaskListId

Get all tasks under a specific task list.

getTaskById

Retrieve a single task by its ID.

createTask

Create a new task in Teamwork.

createSubTask

Create a new subtask under a parent task.

updateTask

Update an existing task.

deleteTask

Delete a task.

getTasksMetricsComplete

Get the total count of completed tasks.

getTasksMetricsLate

Get the total count of late tasks.

getTaskSubtasks

Get all subtasks for a specific task.

getTaskComments

Get comments for a specific task.

createComment

Create a comment related to a task.

getCompanies

Get all companies with optional filtering.

getCompanyById

Get a specific company by ID.

createCompany

Create a new company.

updateCompany

Update a company's information.

deleteCompany

Delete a company.

getPeople

Get all people from Teamwork.

getPersonById

Get a specific person by ID.

getProjectPeople

Get all people assigned to a project.

addPeopleToProject

Add people to a specific project.

deletePerson

Delete a person from Teamwork.

updatePerson

Update a person's information.

getProjectsPeopleMetricsPerformance

Get people metrics performance.

getProjectsPeopleUtilization

Get people utilization.

getProjectPerson

Get a specific person on a project.

getProjectsReportingUserTaskCompletion

Get user task completion reports.

getProjectsReportingUtilization

Get utilization reports in formats like CSV and HTML.

getTime

Get all time entries.

getProjectsAllocationsTime

Get project allocations time.

getTimezones

List all available timezones in Teamwork.