MCP.so
Sign In

Teamwork MCP Server

@readingdancer

Basic information

Category

Other

License

MIT

Transports

stdio

Author

readingdancer

About Teamwork MCP Server

MCP server to connect to the Teamwork API

Teamwork MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Teamwork-MCP": {
      "command": "npx",
      "args": [
        "@vizioz/teamwork-mcp"
      ]
    }
  }
}

Teamwork MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Teamwork MCP?

Teamwork MCP is an MCP server that connects to the Teamwork API, providing a simplified interface for interacting with Teamwork projects and tasks. It is designed for use with MCP-compatible clients such as Cursor and Claude Desktop.

How to use Teamwork MCP?

Install via npx (npx @vizioz/teamwork-mcp) and provide your Teamwork credentials (domain, username, password) through environment variables, a .env file, or command-line arguments. Then add the server to an MCP client like Cursor, Claude Desktop, or Windsurf. The server exposes a wide set of tools for managing projects, tasks, comments, companies, people, reporting, and time entries.

Key features of Teamwork MCP

  • Connects to the Teamwork API and manages projects/tasks
  • Retrieve, create, update, and delete tasks and subtasks
  • Manage companies, people, time entries, and comments
  • Filter available tools using allow/deny lists or groups (Projects, Tasks, etc.)
  • Configurable logging with error and combined log files
  • Support for reporting metrics like user task completion and utilization

Use cases of Teamwork MCP

  • Automate project and task management from an AI assistant within Cursor or Claude
  • Fetch task metrics (completed, late) for dashboards or reporting
  • Add or update people and their assignments on projects
  • Create comments on tasks, messages, or notebooks
  • Generate utilization reports in CSV or HTML format

Frequently asked questions

1

How do I provide my Teamwork credentials?

You can provide credentials in three ways: set the environment variables `TEAMWORK_DOMAIN`, `TEAMWORK_USERNAME`, and `TEAMWORK_PASSWORD`; create a `.env` file with those variables; or pass them as command-line arguments (e.g., `--domain`, `--user`, `--pass`).

2

Can I restrict which tools are available?

Yes. Use the `--allow-tools` or `--allow` flag to specify a comma-separated list of allowed tool names or groups (e.g., `Tasks,Projects`). Use `--deny-tools` or `--deny` to exclude specific tools or groups. If both are provided, allow takes precedence.

3

How do I disable logging?

You can disable logging by adding the `--disable-logging` or `--no-logging` command-line argument, or by setting the `DISABLE_LOGGING=true` environment variable before running npx.

4

What are the prerequisites for using Teamwork MCP?

You need Node.js v14.17 or higher (v18+ or the latest LTS is recommended), npm or yarn, and a Teamwork account with API access.

5

How do I add Teamwork MCP to Cursor or Claude Desktop?

For Cursor (versions after 0.47), edit the MCP config to include a `"Teamwork"` entry with `command: "npx"` and args including `-y`, `@vizioz/teamwork-mcp`, and your credentials. For Claude Desktop, add the same configuration under `mcpServers` in the `claude_desktop_config.json` file.

Comments

More Other MCP servers