Teamwork

Teamwork.com MCP server

create,-apply,-and-query-tags-to-organize-items-across-projects.

14

GitHub Stars

—

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "teamwork-mcp": {
      "command": "go",
      "args": [
        "run",
        "cmd/mcp-stdio/main.go"
      ],
      "env": {
        "TW_MCP_BEARER_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

This Model Context Protocol (MCP) server enables large language models to interact with Teamwork.com projects through a standardized, secure interface. It lets you connect AI tools to Teamwork data so you can automate tasks, manage work items, and access project context from your preferred LLM environment.

How to use

You will run the MCP server in stdio mode and connect your MCP client to it. Start the server with your authentication token in the environment, then provide the tool access to Teamwork project data through the MCP interface. The server exposes actions you can invoke from your AI agent to manage tasks, tags, timers, and related project activities within Teamwork.

How to install

Prerequisites: ensure you have Go 1.26 or later installed on your machine.

Prepare to run the MCP server in stdio mode using the provided Go entry point.

TW_MCP_BEARER_TOKEN=your-token go run cmd/mcp-stdio/main.go

Replace your-token with a valid bearer token for Teamwork.com. This command starts the MCP stdio server in the current environment and waits for input from your MCP client.

## Configuration and runtime notes

The server uses environment variables for authentication. The required variable shown is TW\_MCP\_BEARER\_TOKEN, which carries the bearer token used to authorize requests against Teamwork.com.

Optional security considerations include restricting the bearer token usage scope and applying network access controls to limit who can start or communicate with the MCP server.

## Troubleshooting

If the server fails to start, verify you are using Go 1.26 or newer and that TW\_MCP\_BEARER\_TOKEN is set correctly. Ensure you are executing the command from the repository root where the MCP stdio entry point resides.

## Available tools

### tasks

Manage Teamwork tasks within projects, including creation, updates, and retrieval.

### tags

Create, apply, and query tags to organize items across projects.

### timers

Track time on tasks and export timing data for reporting.