georgeantonopoulos/Basecamp-MCP-Server

Basecamp MCP Server

An MCP server for Basecamp 3. It lets MCP-capable clients such as Codex, Cursor, and Claude Desktop read and manage Basecamp projects through OAuth-authenticated Basecamp API calls.

The main server is basecamp_fastmcp.py. It uses the official mcp.server.fastmcp Python SDK and exposes 79 tools covering projects, todos, message boards, campfires, card tables, inbox forwards, documents, uploads, comments, events, webhooks, and search.

What It Can Do

• Browse Basecamp projects and project details.
• Search across projects, todos, messages, campfire lines, comments, uploads, and schedules.
• Read and manage todolists, todos, todo groups, and completion state.
• Read and create message board messages, including drafts and categories.
• Read campfire lines.
• Read and create comments.
• Work with card tables, columns, cards, and card steps.
• Read inbox forwards and replies.
• Read daily check-ins and answers.
• Upload attachments and inspect uploads.
• Read and manage documents, including drafts.
• List events and manage webhooks.
• Generate local MCP configuration for Codex, Cursor, and Claude Desktop.

Requirements

• Python 3.10 or newer.
• A Basecamp 3 account.
• A Basecamp OAuth application from https://launchpad.37signals.com/integrations.
• A client that can run local MCP servers, such as Codex, Cursor, or Claude Desktop.

If your system Python is older, use uv; it can create a virtual environment with a newer Python version.

Quick Start

Clone the repository and install dependencies:

git clone https://github.com/georgeantonopoulos/Basecamp-