# Teamwork.com MCP server

> Lets AI agents manage Teamwork.com projects, tickets, spaces, and chat through the Model Context Protocol.

- Repository: https://github.com/teamwork/mcp
- Page: https://hostedmcp.org/servers/teamwork/mcp
- Transport: stdio, remote
- Stars: 28
- License: MIT
- Latest version: 1.62.2

## Install

### Claude Code

```sh
claude mcp add --env 'TW_MCP_BEARER_TOKEN=<YOUR_TW_MCP_BEARER_TOKEN>' mcp -- docker run -i --rm docker.io/teamwork/mcp:v1.62.2
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/teamwork/mcp:v1.62.2"
      ],
      "env": {
        "TW_MCP_BEARER_TOKEN": "<YOUR_TW_MCP_BEARER_TOKEN>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/teamwork/mcp:v1.62.2"
      ],
      "env": {
        "TW_MCP_BEARER_TOKEN": "<YOUR_TW_MCP_BEARER_TOKEN>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"docker","args":["run","-i","--rm","docker.io/teamwork/mcp:v1.62.2"],"env":{"TW_MCP_BEARER_TOKEN":"<YOUR_TW_MCP_BEARER_TOKEN>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/teamwork/mcp:v1.62.2"
      ],
      "env": {
        "TW_MCP_BEARER_TOKEN": "<YOUR_TW_MCP_BEARER_TOKEN>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp --env 'TW_MCP_BEARER_TOKEN=<YOUR_TW_MCP_BEARER_TOKEN>' -- docker run -i --rm docker.io/teamwork/mcp:v1.62.2
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "docker"
args = ["run", "-i", "--rm", "docker.io/teamwork/mcp:v1.62.2"]

[mcp_servers.mcp.env]
TW_MCP_BEARER_TOKEN = "<YOUR_TW_MCP_BEARER_TOKEN>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'TW_MCP_BEARER_TOKEN=<YOUR_TW_MCP_BEARER_TOKEN>' mcp docker -- run -i --rm docker.io/teamwork/mcp:v1.62.2
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/teamwork/mcp:v1.62.2"
      ],
      "env": {
        "TW_MCP_BEARER_TOKEN": "<YOUR_TW_MCP_BEARER_TOKEN>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `TW_MCP_BEARER_TOKEN` | yes | yes | API key generated from the Teamwork.com OAuth2 process: https://apidocs.teamwork.com/guides/teamwork/app-login-flow |
| `NODE_EXTRA_CA_CERTS` | no | no |  |
| `TW_MCP_LOG_FORMAT` | no | no | Choose log output format between 'text' or 'json'. Default is 'text'. |
| `TW_MCP_LOG_LEVEL` | no | no | Choose log level between 'debug', 'info', 'warn' or 'error'. Default is 'info'. |
| `TW_MCP_SERVER_ADDRESS` | no | no |  |

## FAQ

### What can the Teamwork.com MCP server do?

It exposes Teamwork.com create/read/update operations across Projects, Desk, Spaces, and Chat so AI agents can run project management tasks.

### How do I authenticate the Teamwork.com MCP server?

It supports a bearer token or OAuth2 integration with Teamwork.com.

### Which transport modes does the Teamwork.com MCP server support?

It offers HTTP and STDIO interfaces for different deployment scenarios, plus an HTTP CLI for testing.

### Can I restrict the Teamwork.com MCP server to read-only operations?

Yes, an optional read-only mode limits the server to read-only operations for safety.

### What are the prerequisites for running the Teamwork.com MCP server?

You need Go 1.27 or later and valid Teamwork.com API credentials, either a bearer token or OAuth2 setup.