Fizzy MCP Server

Fizzy MCP

AI-Native Task Management with Model Context Protocol

Connect your AI assistant to Fizzy for intelligent, context-aware project management.

Documentation • Quick Start • Issues

What is Fizzy MCP?

Fizzy MCP is an open-source Model Context Protocol server that enables AI assistants to interact with Fizzy, Basecamp's task management tool.

With Fizzy MCP, your AI can:

• Read your boards and cards - Get full context about your projects
• Create new cards - Add tasks directly from conversation
• Update existing cards - Modify descriptions, tags, and status
• Move cards - Triage cards to columns, postpone, or close them
• Add comments - Leave notes and updates on cards

Quick Start

npx fizzy-do-mcp@latest configure

The wizard will:

1. Detect your installed editors (Claude Desktop, Cursor, etc.)
2. Prompt for your Fizzy API token
3. Configure each editor automatically

Or configure manually:

{
  "mcpServers": {
    "fizzy": {
      "command": "npx",
      "args": ["-y", "fizzy-do-mcp@latest"],
      "env": {
        "FIZZY_TOKEN": "your-fizzy-api-token"
      }
    }
  }
}

Supported Editors

Example Usage

You: What's on my Engineering board?

AI: I found 12 open cards on your Engineering board:

In Progress:
- #234 "Implement user authentication" (assigned to you)
- #235 "API rate limiting"

Needs Triage:
- #240 "Database migration script"
- #241 "Update dependencies"

You: Create a card for adding dark mode support

AI: Created card #242 "Add dark mode support" on the Engineering board.
    Would you like me to add any tags or assign it to someone?

Available Tools

Fizzy MCP provides 40+ tools covering all major Fizzy operations:

See the Tools Reference for complete documentation.

Architecture

fizzy-do-mcp/
├── packages/
│   ├── shared/      # Types, schemas, Result type
│   ├── client/      # Type-safe HTTP client for Fizzy API
│   └── tools/       # MCP tool definitions
├── apps/
│   ├── server/      # CLI and MCP server (npm: fizzy-do-mcp)
│   └── hosted/      # Hosted proxy service (Cloudflare Workers)
└── docs/            # Documentation site (VitePress)

Deployment Options

Local Server (Recommended)

• Run via npx fizzy-do-mcp@latest
• Maximum privacy - tokens stay on your machine
• No rate limits

Hosted Proxy

• Available at https://mcp.fizzy.yogan.dev
• Use X-Fizzy-Token header for authentication
• Useful for environments where npx isn't available

Development

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run type checker
pnpm typecheck

# Run linter
pnpm lint

# Develop the CLI
cd apps/server
pnpm dev

# Develop docs
cd docs
pnpm dev

Requirements

• Node.js 20+ - For running the local MCP server
• Fizzy Account - Sign up at fizzy.do
• **A