mcp

Teamwork MCP Server

Model Context Protocol server for Teamwork.com integration with Large Language Models

📖 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 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 (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
• 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 MCP server:

📡 HTTP Server

Production-ready HTTP server for cloud deployments and multi-client support.

📖 Full HTTP Server Documentation

Quick start:

TW_MCP_SERVER_ADDRESS=:8012 go run cmd/mcp-http/main.go

💬 STDIO Server

Direct STDIO interface for desktop applications and development environments.

📖 Full STDIO Server Documentation

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.

📖 Full HTTP CLI Documentation

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 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
├── internal/
│   ├── config/           # Configuration management
│   ├── helpers/          # Utility functions
│   ├── toolsets/         # Tool framework and management
│   └── twprojects/       # Teamwork project operations
├── examples/             # Usage examples and integrations
├── chart/                # Kubernetes Helm chart
└── Dockerfile            # Container build configuration