Basecamp 3用のMCPサーバーです。Codex、Cursor、Claude DesktopなどのMCP対応クライアントが、OAuth認証済みのBasecamp APIコールを通じてBasecampプロジェクトの読み取りと管理を可能にします。

メインサーバーはbasecamp_fastmcp.pyです。公式のmcp.server.fastmcp Python SDKを使用し、プロジェクト、Todo、掲示板、キャンプファイヤー、カードテーブル、受信トレイ転送、ドキュメント、アップロード、コメント、イベント、ウェブフック、検索を含む79のツールを公開しています。

それができること

• Basecampのプロジェクトやプロジェクト詳細を閲覧。
• プロジェクト、ToDo、メッセージ、キャンプファイヤーの列、コメント、アップロード、スケジュールを横断して検索。
• トドリスト、トイリスト、トイレグループ、完了状態の閲覧と管理。
• 掲示板のメッセージを読み、作成すること。下書きやカテゴリも含めて。
• キャンプファイヤーのセリフを読んで。
• 読んでコメントを作成する。
• カードテーブル、列、カード、カードステップの作業。
• 受信箱の転送や返信を読むこと。
• 日々のチェックインと回答を読むこと。
• 添付ファイルのアップロードとアップロードの検査。
• 文書の閲覧と管理、下書きを含む。
• イベントをリストアップし、ウェブフックを管理します。
• Codex、カーソル、Claude DesktopのローカルMCP構成を生成する。

要件

• Python 3.10以降。
• Basecamp 3のアカウントです。

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 .
• 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-MCP-Server.git
cd Basecamp-MCP-Server

uv venv --python 3.12 venv
source venv/bin/activate
uv pip install -r requirements.txt

Or, if python already points to Python 3.10 or newer:

python setup.py

Create a .env file from the example and fill in your Basecamp OAuth details:

cp .env.example .env

Required values:

BASECAMP_CLIENT_ID=your-client-id
BASECAMP_CLIENT_SECRET=your-client-secret
BASECAMP_ACCOUNT_ID=your-account-id
USER_AGENT="Your App Name ([email protected])"

Authenticate with Basecamp:

python oauth_app.py

Open and complete the OAuth flow. The token is stored locally in oauth_tokens.json by default.

Configure Your MCP Client

Codex

python generate_codex_config.py
codex mcp get basecamp

Useful options:

python generate_codex_config.py --dry-run
python generate_codex_config.py --legacy