Basecamp

Basecamp MCP Server provides a FastMCP-powered integration that exposes Basecamp 3 functionality to MCP clients (such as Cursor, Codex, and Claude Desktop). It translates Basecamp capabilities into MCP tools, granting AI clients programmatic access to manage projects, todos, messages, comments, and more within Basecamp. After setup and authentication, the server presents 75 tools that mirror Basecamp operations, enabling tasks like listing projects, creating and updating todo lists and items, managing comments, searching across projects, and interacting with campfire messages. Use the MCP endpoints and the provided tool names to perform common Basecamp actions through your AI client. The server is designed to work with the FastMCP framework, ensuring protocol compliance and predictable behavior across supported clients.

Prerequisites:

• Python 3.10+ (or use uv to auto-download the correct version)
• Basecamp 3 account and a Basecamp OAuth application (create one at https://launchpad.37signals.com/integrations)

1. Clone the repository:

git clone <repository-url>
cd Basecamp-MCP-Server

2. Set up a Python environment and install dependencies (recommended with uv):

# Using uv (recommended — auto-downloads Python 3.12)
uv venv --python 3.12 venv
source venv/bin/activate  # or venv\Scripts\activate on Windows
uv pip install -r requirements.txt
uv pip install mcp

3. Alternative (if you prefer plain Python setup):

pip install -r requirements.txt

4. Configure OAuth credentials:

• Edit the generated .env file with your Basecamp credentials:

BASECAMP_CLIENT_ID=your_client_id_here
BASECAMP_CLIENT_SECRET=your_client_secret_here
BASECAMP_ACCOUNT_ID=your_account_id_here
USER_AGENT="Your App Name (your@email.com)"

5. Authenticate with Basecamp:

python oauth_app.py

Visit http://localhost:8000 and complete the OAuth flow.

6. Run server script to generate clients/configs as needed (example shown in README):

• For Cursor: generate_cursor_config.py
• For Codex: generate_codex_config.py
• For Claude Desktop: generate_claude_desktop_config.py

7. Start your MCP server (as demonstrated in the mcp_config section):

# Example (from the documented setup):
python basecamp_fastmcp.py

8. Verify integration in clients by listing tools and performing test RPCs, e.g., initialize and tools/list as shown in the README.

Tips and common issues:

• Ensure the OAuth flow completes and oauth_tokens.json exists; otherwise authentication will fail.
• If Tools don’t appear in your client, double-check the MCP server config and restart the client application.
• Use absolute paths in Claude Desktop configuration to avoid environment path issues.
• The integration exposes 75 tools; consult the available tools list to understand supported Basecamp actions (projects, todos, comments, campfire messages, and searches).
• When using Claude Desktop, the configuration file is created under the user’s Claude config path; ensure the path permissions allow writing to that location.
• For debugging, monitor logs via the Claude Desktop or server-specific log locations as described in the Claude Desktop troubleshooting section.