Teamwork MCP

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

FAQ from Teamwork MCP

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).

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.

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.

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.

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.