Teamwork/mcp
If you are the rightful owner of mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Teamwork MCP Server facilitates integration between Teamwork.com and Large Language Models, enabling AI-driven project management.
Teamwork MCP Server
Model Context Protocol server for Teamwork.com integration with Large Language Models
๐ Are you a Teamwork.com user wanting to connect AI tools (Claude Desktop, VS Code Copilot Chat, Gemini, etc.) to your Teamwork.com site right now? Jump straight to the for tokens, enabling MCP and client configuration examples.
๐ Overview
This MCP (Model Context Protocol) server enables seamless integration between Large Language Models and Teamwork.com. It provides a standardized interface for LLMs to interact with Teamwork.com projects, allowing AI agents to perform various project management operations.
๐ค What is MCP?
Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to LLMs. This server describes all the actions available in Teamwork.com (tools) in a way that LLMs can understand and execute through AI agents.
โจ Features
- Multiple Transport Modes: HTTP and STDIO interfaces for different deployment scenarios
- Secure Authentication: Bearer token and OAuth2 integration with Teamwork.com
- Tool Framework: Extensible toolset architecture for adding new capabilities
- Production Ready: Comprehensive logging, monitoring, and observability
- Read-Only Mode: Optional restriction to read-only operations for safety
๐ Available Servers
This project provides three different ways to interact with the Teamwork.com MCP server:
๐ก HTTP Server
Production-ready HTTP server for cloud deployments and multi-client support.
๐
Quick start:
TW_MCP_SERVER_ADDRESS=:8080 go run cmd/mcp-http/main.go
๐ฌ STDIO Server
Direct STDIO interface for desktop applications and development environments.
๐
Quick start:
TW_MCP_BEARER_TOKEN=your-token go run cmd/mcp-stdio/main.go
๐ ๏ธ HTTP CLI
Command-line tool for testing and debugging MCP server functionality.
๐
Quick start:
go run cmd/mcp-http-cli/main.go -mcp-url=https://mcp.example.com list-tools
๐ Prerequisites
- Go 1.24 or later
- Valid Teamwork.com API credentials (bearer token or OAuth2 setup)
๐งช Development & Testing
Running Tests
# Run all tests
go test ./...
# Run specific package tests
go test ./internal/twprojects/
MCP Inspector
For debugging purposes, use the MCP Inspector tool:
NODE_EXTRA_CA_CERTS=letsencrypt-stg-root-x1.pem npx @modelcontextprotocol/inspector node build/index.js
[!IMPORTANT] Note: The
NODE_EXTRA_CA_CERTS
environment variable is required when using OAuth2 authentication with the Let's Encrypt certification authority. Download the certificate here.
๐๏ธ Architecture
โโโ cmd/
โ โโโ mcp-http/ # HTTP server implementation
โ โโโ mcp-stdio/ # STDIO server implementation
โ โโโ mcp-http-cli/ # CLI tool for testing via HTTP
โโโ internal/
โ โโโ auth/ # Authentication helpers (bearer & OAuth2 token handling)
โ โโโ config/ # Configuration management (env, flags)
โ โโโ helpers/ # Shared utility functions (errors, link helpers, tool parsing)
โ โโโ request/ # HTTP request primitives / Teamwork API wiring
โ โโโ toolsets/ # Tool framework and registration logic
โ โโโ twprojects/ # Teamwork project/domain tools (tasks, tags, timers, etc.)
โโโ examples/ # Usage & integration examples (LangChain Node/Python)
โโโ usage.md # End-user setup & connection guide
โโโ Makefile # Common developer tasks
โโโ Dockerfile # Container build configuration
โโโ CODE_OF_CONDUCT.md # Community guidelines
โโโ CONTRIBUTING.md # Contribution guide
โโโ SECURITY.md # Security policy