Skip to main content
Glama
FarisHijazi
by FarisHijazi

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

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FarisHijazi/basecamp-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server