Basecamp CLI for Openclaw

A robust CLI and MCP server enabling AI-driven automation for Basecamp 4 project management.

drkraft
v2.0.0
Feb 3, 2026
0
3.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install basecamp-cli-mcp

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install basecamp-cli-mcp using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Basecamp CLI?

Basecamp CLI is a comprehensive toolset designed to bridge the gap between Basecamp 4 and your local development environment or AI assistants. As a key component within the Openclaw Skills ecosystem, it provides both a traditional Command Line Interface and a Model Context Protocol (MCP) server. This dual-purpose utility enables developers to execute 21 different command groups and allows AI agents to access 76 specialized tools for project management. By leveraging this skill, teams can automate the creation of todos, manage kanban boards, and query project documentation without ever leaving their terminal or AI chat interface.

The tool is built for reliability, featuring automatic pagination for large data sets and exponential backoff for API retries. It handles the complexities of OAuth 2.0 authentication with PKCE, ensuring secure access to your 37signals account data. Whether you are building custom automation scripts or enhancing an AI agent's capabilities, this skill provides the necessary infrastructure to interact deeply with Basecamp's API surface.

Basecamp CLI Use Cases

  • Automating the generation of weekly project reports by querying messages and completed todos.
  • Scaling project setups by programmatically creating todolists and campfire rooms for new clients.
  • Enabling AI agents to move kanban cards across columns based on developer progress updates.
  • Searching across multiple projects for specific documents or uploads via the terminal.
  • Synchronizing local project assets with Basecamp Vaults and Documents automatically.

How Basecamp CLI Works

  1. The user installs the package via npm and sets up an OAuth application through the 37signals Launchpad to obtain credentials.
  2. The developer configures the environment variables and performs a one-time login to establish a secure authenticated session.
  3. For AI-based workflows, the basecamp-mcp server is added to a compatible host like Claude Desktop, making the 76 tools available to the assistant.
  4. When a command or tool is invoked, the skill translates the request into a valid Basecamp 4 API call, handling all necessary headers and parameters.
  5. The tool processes the API response, applying pagination if needed, and returns the data in a clean format or as part of the Openclaw Skills data exchange.
  6. For CLI users, the --format json flag allows for easy piping of output into other developer tools like jq.

Basecamp CLI Setup

To integrate this into your workflow, follow these installation and configuration steps:

# Install the package globally
npm install -g @drkraft/basecamp-cli

# Configure your OAuth client ID
basecamp auth configure --client-id <your-client-id>

# Set required environment variables
export BASECAMP_CLIENT_SECRET="<your-client-secret>"
export BASECAMP_CLIENT_ID="<your-client-id>"

# Log in to authenticate your account
basecamp auth login

Basecamp CLI Data Schema & Taxonomy

The skill interacts with the Basecamp 4 object model and can export data in structured JSON format. Below is the mapping of core entities managed by this Openclaw Skills entry:

Entity Managed Attributes
Projects ID, Name, Description, Status, Purpose
Todo Lists ID, Title, Description, Position, Status
Todos Content, Due Date, Assignees, Completion Status
Card Tables Column IDs, Card Titles, Positions, Descriptions
Vaults/Docs File Metadata, HTML Content, Parent IDs
Webhooks Target URL, Event Types, Secret Keys

Basecamp CLI Advanced Features

  • Comprehensive MCP Integration: Features 76 tools for AI assistants to perform deep project management tasks.
  • Kanban Management: Full support for Card Tables, including column manipulation and card movement.
  • Rich Search: Powerful search capabilities to find specific text across todos, documents, and messages.
  • Recording Lifecycle: Advanced tools to archive, trash, or restore any recording within the Basecamp ecosystem.
  • Event Monitoring: Access to project event streams and webhook configuration for real-time automation triggers.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins basecamp-mcp
Github Stars: 0
forks: 0

Featured*