iflow-mcp_georgeantonopoulos-basecamp-mcp-server

# Basecamp MCP Integration This project provides a **FastMCP-powered** integration for Basecamp 3, allowing Cursor to interact with Basecamp directly through the MCP protocol. ✅ **Migration Complete:** Successfully migrated to official Anthropic FastMCP framework with **100% feature parity** (all 63 tools) 🚀 **Ready for Production:** Full protocol compliance with MCP 2025-06-18 ## Quick Setup This server works with both **Cursor** and **Claude Desktop**. Choose your preferred client: ### Prerequisites - **Python 3.10+** (required for MCP SDK) — or use `uv` which auto-downloads the correct version - A Basecamp 3 account - A Basecamp OAuth application (create one at <https://launchpad.37signals.com/integrations>) ## For Cursor Users ### One-Command Setup 1. **Clone and set up with uv (recommended):** ```bash git clone <repository-url> cd basecamp-mcp # 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 ``` **Alternative: Using pip** (requires Python 3.10+ already installed): ```bash python setup.py ``` The setup automatically: - ✅ Creates virtual environment - ✅ Installs all dependencies (FastMCP SDK, etc.) - ✅ Creates `.env` template file - ✅ Tests MCP server functionality 2. **Configure OAuth credentials:** Edit the generated `.env` file: ```bash 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)" ``` 3. **Authenticate with Basecamp:** ```bash python oauth_app.py ``` Visit <http://localhost:8000> and complete the OAuth flow. 4. **Generate Cursor configuration:** ```bash python generate_cursor_config.py ``` 5. **Restart Cursor completely** (quit and reopen, not just reload) 6. **Verify …