SkillFoxx

Basecamp MCP Server

Basecamp 3 and 4 MCP server: 210 operations over projects, to-dos, messages and cards, with four compact tools by default.

  • 101 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • The server reads and changes projects, to-dos, messages, permissions and webhooks in your Basecamp.
  • The OAuth app and token are stored in files on your machine.
All reasons and checks

georgeantonopoulos/basecamp-mcp-serverAuthor:georgeantonopoulos

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/basecamp-mcp-server

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The server reads and changes projects, to-dos, messages, permissions and webhooks in your Basecamp.
  • The OAuth app and token are stored in files on your machine.

This is third-party code. Review the repository files before installing.

What it does

The server connects Claude, Cursor, Codex and other clients to a Basecamp account. The agent finds, reads, creates and updates projects, to-dos and lists, messages and comments, Campfire chats, schedule events, card table cards, documents and attachments, timesheets and progress charts, notifications and webhooks. By default the client sees four small tools that find and run the right one of 210 operations. This saves context, and reading and writing are separate tools, so clients that ask before changes will ask here too. The `--full` flag lists all 210 tools up front. Long lists come back as summaries, and the full view is requested with `detail: "full"`.

Who it is for. Managers and team members on Basecamp who want to ask an agent about tasks and projects in plain language and hand it routine work.

Good fit when

  • The morning starts with finding what is overdue across all projects.
  • A digest of a week of messages in the Website project is needed.
  • A card must move to the Done column with a comment that it shipped.
  • A project member must be granted or denied access.

Not a fit when

  • Another tracker is used instead of Basecamp.
  • One shared server per team is wanted; the project is built for one person and the author notes must be read before hosting it for a team.
  • The token cannot be stored on the local machine.

Example request

Show what is overdue across all my Basecamp projects, group it by project and suggest which tasks to reassign.

MCP

Transport
stdio, http
Authentication
OAuth

Environment variables

BASECAMP_ACCOUNT_ID
Fallback account number when the token does not record one.

Limitations

Needs `uv` and a Basecamp 3 or 4 account. The first sign-in (`uvx basecamp-mcp-server login`) asks you to register a free Basecamp app and set a redirect address. The app secret and token sit on your machine in `~/.config/basecamp-mcp-server/` and must not be committed. The server is built for local use by one person. In HTTP mode each user signs in with their own login, and HTTPS hosting is up to you. Write operations are marked, but their scope is wide: projects, permissions and webhooks can all change.

How to disable. Run `claude mcp remove basecamp`, then delete the `~/.config/basecamp-mcp-server/` folder with the tokens and revoke the app at launchpad.37signals.com.

FAQ

How do I connect it to Claude Code?

First `uvx basecamp-mcp-server login`, then `claude mcp add basecamp -- uvx basecamp-mcp-server`. A ready snippet for any client is printed by `uvx basecamp-mcp-server config <client>`.

How do four tools differ from 210?

The four tools find the right operation and run it on demand, so the client context stays small. All 210 are shown at once with the `--full` flag.

Can claude.ai connect through a URL?

Yes, through HTTP mode: `uvx basecamp-mcp-server serve` behind HTTPS, then a custom connector at the `/mcp` address. Each person signs in to Basecamp with their own login.

What about several Basecamp accounts?

`login` asks which one to use, or pass `--account-id` with the number from the Basecamp URL, such as `1234567`.

How do I sign in on a machine without a browser?

Run `uvx basecamp-mcp-server login --no-browser`, open the printed link in any browser that can reach `localhost` of that machine and approve.

Discussion

No questions or reviews yet.

MCP servers
Official

The official Basecamp CLI, with plugins for Claude Code and Codex, lets you run projects and todos from the terminal or an agent

CLIBroad access299
Official

A free task manager with issues, sprints and docs and a built-in MCP server with about sixty tools.

MCP serverExtended access81
Official

The official Taskade MCP and plugin: an agent manages workspace projects, tasks, automations and AI agents.

MCP serverBroad access169

An MCP server for Redmine: issues, projects, wikis, time tracking and files, a read-only mode and per-user OAuth2 sign-in

MCP serverBroad access92

Trello MCP server with 57 tools: cards, lists, checklists, attachments, comments, custom fields and workspaces, plus acceptance-criteria extraction

MCP serverBroad access447

README in short

The server is written in Python with FastMCP and published on PyPI as `basecamp-mcp-server`. It combines a local stdio mode and a hosted HTTP mode with OAuth and keeps an operation search tool.

README badge

Report a problem