Teamwork MCP Server

Teamwork MCP Server

Seamless Teamwork.com integration for Large Language Models via the Model Context Protocol

View on GitHub Visit Website
11
Stars
9
Forks
11
Watchers
4
Issues
Teamwork MCP Server is an implementation of the Model Context Protocol (MCP) that enables Large Language Models to interact securely and programmatically with Teamwork.com. It offers standardized interfaces, including HTTP and STDIO, allowing AI agents to perform various project management operations. The server supports multiple authentication methods, an extensible toolset architecture, and is designed for production deployments. It provides read-only capability for safe integrations and robust observability features.

Key Features

Supports both HTTP and STDIO transport modes for flexible deployment options
Secure authentication with bearer token and OAuth2 integration
Extensible toolset architecture for customizable AI operations
Production-ready design with logging, monitoring, and observability
Optional read-only mode for safe AI integration
Multiple server modes including command-line interface
Standardized interface for LLM interaction with project management tools
Documentation and examples for quick setup
Comprehensive test suite for reliability
Support for debugging using external MCP Inspector tool

Use Cases

Connecting Large Language Models to Teamwork.com for context-aware task automation
Enabling AI assistants to fetch and update project information on Teamwork.com
Integrating chatbots or IDE plugins (like Copilot, Gemini, Claude) with Teamwork.com projects
Automating routine project management tasks via AI agents in enterprise environments
Building custom workflow automation tools leveraging Teamwork.com data
Testing and debugging MCP endpoints using CLI and external inspector utilities
Securing third-party client access to Teamwork.com through bearer/OAuth2 authentication
Deploying LLM-powered applications in production with auditing and observability
Restricting AI integrations to read-only access for sensitive project environments
Extending Teamwork.com capabilities with new AI-driven tools and actions

README

Teamwork MCP Server

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

Go MCP

📌 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 Usage Guide (How to Connect) 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.

📖 Full HTTP Server Documentation

Quick start:

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

💬 STDIO Server

Direct STDIO interface for desktop applications and development environments.

📖 Full STDIO Server Documentation

Quick start:

bash
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:

bash
go run cmd/mcp-http-cli/main.go -mcp-url=https://mcp.example.com list-tools

📋 Prerequisites

  • Go 1.25 or later
  • Valid Teamwork.com API credentials (bearer token or OAuth2 setup)

🧪 Development & Testing

Running Tests

bash
# Run all tests
go test ./...

# Run specific package tests
go test ./internal/twprojects/

MCP Inspector

For debugging purposes, use the MCP Inspector tool:

bash
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

Star History

Star History Chart

Repository Owner

Teamwork
Teamwork

Organization

Repository Details

Language Go
Default Branch main
Size 27,079 KB
Contributors 4
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Go
98.78%
Dockerfile
0.84%
Makefile
0.37%

Tags

Go server OAuth2 Authentication http-server developer tooling

Topics

ai artificial-intelligence mcp mcp-server mcp-tools teamwork

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • TickTick MCP

    TickTick MCP

    MCP server for AI-powered TickTick task management integration

    TickTick MCP is a Model Context Protocol (MCP) server that enables standardized integration of TickTick's task management features with AI assistants and developer applications. It allows programmatic access to create, update, retrieve, complete, or delete tasks and projects in TickTick via Python. Using this MCP server, AI systems can leverage TickTick's API to help automate and manage user's to-do lists and projects through natural language or other interfaces.

    • ⭐ 6
    • MCP
    • ekkyarmandi/ticktick-mcp
  • Plane MCP Server

    Plane MCP Server

    Enables LLMs to manage Plane.so projects and issues via the Model Context Protocol.

    Plane MCP Server provides a standardized interface to connect large language models with Plane.so project management APIs. It enables LLMs to interact directly with project and issue data, supporting tasks such as listing projects, retrieving detailed information, creating and updating issues, while prioritizing user control and security. Installation is streamlined through tools like Smithery, and configuration supports multiple clients including Claude for Desktop.

    • ⭐ 32
    • MCP
    • kelvin6365/plane-mcp-server
  • MyMCP Server (All-in-One Model Context Protocol)

    MyMCP Server (All-in-One Model Context Protocol)

    Powerful and extensible Model Context Protocol server with developer and productivity integrations.

    MyMCP Server is a robust Model Context Protocol (MCP) server implementation that integrates with services like GitLab, Jira, Confluence, YouTube, Google Workspace, and more. It provides AI-powered search, contextual tool execution, and workflow automation for development and productivity tasks. The system supports extensive configuration and enables selective activation of grouped toolsets for various environments. Installation and deployment are streamlined, with both automated and manual setup options available.

    • ⭐ 93
    • MCP
    • nguyenvanduocit/all-in-one-model-context-protocol
  • mcp-cli

    mcp-cli

    A command-line inspector and client for the Model Context Protocol

    mcp-cli is a command-line interface tool designed to interact with Model Context Protocol (MCP) servers. It allows users to run and connect to MCP servers from various sources, inspect available tools, resources, and prompts, and execute commands non-interactively or interactively. The tool supports OAuth for various server types, making integration and automation seamless for developers working with MCP-compliant servers.

    • ⭐ 391
    • MCP
    • wong2/mcp-cli
  • TickTick MCP Server

    TickTick MCP Server

    Enable powerful AI-driven task management for TickTick via the Model Context Protocol.

    TickTick MCP Server provides comprehensive programmatic access to TickTick task management features using the Model Context Protocol. Built on the ticktick-py library, it enables AI assistants and MCP-compatible applications to create, update, retrieve, and filter tasks with improved precision and flexibility. The server supports advanced filtering, project and tag management, subtask handling, and robust context management for seamless AI integration.

    • ⭐ 35
    • MCP
    • jen6/ticktick-mcp
  • HackMD MCP Server

    HackMD MCP Server

    MCP server connecting LLM clients to the HackMD collaborative note platform.

    HackMD MCP Server implements the Model Context Protocol (MCP) to provide a standardized interface between large language model (LLM) clients and the HackMD collaborative note service. Through HTTP and STDIO transports, it enables creation, retrieval, update, and deletion of notes, along with management of teams, user profiles, and history data. It supports deployment in both local and cloud environments, with secure API token-based authentication and configuration via environment variables or HTTP headers.

    • ⭐ 43
    • MCP
    • yuna0x0/hackmd-mcp
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results