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

by FarisHijazi

Overview Schema Source Related Servers Discussions Admin

Python

Remote

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: basecamp-mcp

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

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

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
FlowraOAuth
io.github.flowradev
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agent Orchestration Autonomous Agents
11

Related MCP Servers

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 7 months ago (2026-03-23 17:26 UTC)
1
MIT
basecamp-mcp
Project Management Communication
jpaoad31
A
license
Not graded
quality
D
maintenance
Enables interacting with Basecamp projects, todos, messages, chats, and more through MCP tools, wrapping the basecamp CLI.
Updated 4 months ago (2026-07-04 03:27 UTC)
64 npm
MIT
Basecamp MCP Server
Project Management Workplace & Productivity Communication
CynthiaMoretti23205
F
license
Not graded
quality
A
maintenance
Enables MCP-capable clients to browse, search, and manage Basecamp 3 projects, todolists, todos, messages, campfires, card tables, inbox forwards, documents, uploads, comments, events, and webhooks through OAuth-authenticated API calls, including downloading attachments as readable content.
Updated 8 days ago (2026-10-15 18:55 UTC)
-
Basecamp MCP Server
Project Management Workplace & Productivity Communication
gPereira81
F
license
Not graded
quality
A
maintenance
Enables MCP-capable clients to securely read and manage Basecamp 3 projects via OAuth-authenticated API calls, with tools for projects, todos, messages, card tables, documents, uploads, comments, events, webhooks, and search.
Updated 5 days ago (2026-10-18 04:54 UTC)
-

basecamp-mcp

Prerequisites

Quick Start

Claude Code MCP Config

Usage

Environment Variables

Available Tools (49)

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Basecamp MCP Server

basecamp-mcp

Basecamp MCP Server

Basecamp MCP Server