Which integrations are available for this server?

Provides tools for interacting with Basecamp, including managing projects, todos, todolists, messages, comments, chat, cards, files, schedule entries, people, search, and more via the Basecamp CLI.

How do I use basecamp-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@basecamp-mcp list all my projects" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

basecamp-mcp

MCP (Model Context Protocol) server for Basecamp CLI.

Exposes Basecamp commands as MCP tools over HTTP or stdio. Shells out to the basecamp CLI binary, so all auth, config, and output formatting is handled by the CLI.

Prerequisites

Basecamp CLI installed and authenticated (basecamp auth login)
Python 3.11+ / uv

Related MCP server: TaskWarrior MCP Server

Quick Start

One command to start the server:

uvx --from "git+https://github.com/FarisHijazi/basecamp-mcp.git" basecamp-mcp --port 8818

Then add it to Claude Code:

claude mcp add --transport http basecamp http://localhost:8818/mcp --scope user

That's it. Start a new Claude Code session and you'll have all 49 Basecamp tools available.

Claude Code MCP Config

If you prefer to configure manually, add this to your .mcp.json (project-level) or ~/.claude.json (global):

HTTP mode (run the server yourself):

{
  "mcpServers": {
    "basecamp": {
      "type": "url",
      "url": "http://localhost:8818/mcp"
    }
  }
}

Stdio mode (Claude Code spawns the process automatically):

{
  "mcpServers": {
    "basecamp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from", "git+https://github.com/FarisHijazi/basecamp-mcp.git",
        "basecamp-mcp", "--stdio"
      ]
    }
  }
}

Usage

# Run from GitHub (no install needed)
uvx --from "git+https://github.com/FarisHijazi/basecamp-mcp.git" basecamp-mcp --port 8818

# Or install locally
uv pip install -e .
basecamp-mcp --port 8818

# Stdio transport (for local Claude Code)
basecamp-mcp --stdio

Environment Variables

Variable	Default	Description
`BASECAMP_BINARY`	`basecamp`	Path to the basecamp CLI binary

Available Tools (49)

All tools shell out to basecamp --agent <command> [args].

Tool	CLI Equivalent
`basecamp_projects_list`	`basecamp projects list`
`basecamp_projects_show`	`basecamp projects show`
`basecamp_projects_create`	`basecamp projects create`
`basecamp_todos_list`	`basecamp todos list`
`basecamp_todos_create`	`basecamp todos create`
`basecamp_todos_complete`	`basecamp todos complete`
`basecamp_todos_update`	`basecamp todos update`
`basecamp_todolists_list`	`basecamp todolists list`
`basecamp_messages_list`	`basecamp messages list`
`basecamp_messages_create`	`basecamp messages create`
`basecamp_comments_create`	`basecamp comments create`
`basecamp_chat_post`	`basecamp chat post`
`basecamp_cards_list`	`basecamp cards list`
`basecamp_cards_move`	`basecamp cards move`
`basecamp_files_list`	`basecamp files list`
`basecamp_schedule_entries`	`basecamp schedule entries`
`basecamp_people_list`	`basecamp people list`
`basecamp_search`	`basecamp search`
`basecamp_show`	`basecamp show`
`basecamp_me`	`basecamp me`
`basecamp_accounts_list`	`basecamp accounts list`
`basecamp_notifications_list`	`basecamp notifications list`
`basecamp_reports_assigned`	`basecamp reports assigned`
`basecamp_reports_overdue`	`basecamp reports overdue`
`basecamp_api`	`basecamp api`
`basecamp_url`	`basecamp url`
... and 23 more

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

mcp-serverOAuth
com.niftypm
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Project Management Communication File Systems
2
mcpOAuth
net.todoist
Official Todoist MCP server for AI assistants to manage tasks, projects, and workflows.
App Automation Workplace & Productivity Project Management
2
mission-controlOAuth
io.github.dinof777
Read and write Mission Control state via MCP — projects, tasks, subtasks, templates, status updates.
Project Management Workplace & Productivity
2
Todo MCP A
io.github.AnkitPat
Create, list, and complete todo items through MCP.
Project Management Workplace & Productivity
1

Related MCP Servers

Basecamp MCP Server
Project Management Communication
QusaiiSaleem
A
license
Not graded
quality
D
maintenance
A professional MCP server providing complete programmatic access to Basecamp 4 API for AI agents, workflow automation, and custom integrations.
Updated a year ago (2025-09-30 08:22 UTC)
5
MIT
TaskWarrior MCP Server
Project Management App Automation
omniwaifu
A
license
Not graded
quality
A
maintenance
MCP server that wraps TaskWarrior command-line tool. Provides 22 tools for task management, GTD workflow, and habit tracking.
Updated 9 days ago (2026-09-06 14:33 UTC)
6 npm
9
MIT
Basecamp MCP Server
Project Management Communication
Attri-Inc
A
license
Not graded
quality
D
maintenance
Multi-user MCP server for Basecamp 3 with 148+ tools, enabling AI clients to manage projects, todos, messages, and more via stdio or multi-tenant HTTP.
Updated 6 months ago (2026-03-23 17:26 UTC)
1
MIT
Basecamp 2 MCP Server
Project Management Communication
envisialearning
F
license
B
quality
C
maintenance
An MCP server that wraps the Basecamp 2 REST API, enabling Claude to create and manage todos, projects, and people through natural language.
Updated 2 months ago (2026-07-08 20:43 UTC)
13
-