Fizzy Do MCP

What is Fizzy Do MCP?

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

No limits. No subscriptions. Just connect and go.

With Fizzy Do 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
• Manage columns and tags - Organize your workflow

Quick Start

Option 1: Local Server (Recommended)

Run the interactive setup wizard:

npx fizzy-do-mcp configure

The wizard will:

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

Or configure manually:

Add to your editor's MCP configuration:

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

Tip: You can also use the fdm alias: npx fdm configure

Option 2: Remote Server

For environments where npx isn't available (like web-based AI tools), use the hosted proxy:

{
  "mcpServers": {
    "fizzy": {
      "url": "https://mcp.fizzy.yogan.dev/sse",
      "headers": {
        "X-Fizzy-Token": "your-fizzy-api-token"
      }
    }
  }
}

The remote server is free with no rate limits - same as local.

Supported Editors

| Editor | Status | Configuration | |--------|--------|---------------| | Claude Desktop | ✅ Full support | Guide | | Claude Code | ✅ Full support | Guide | | Cursor | ✅ Full support | Guide | | OpenCode | ✅ Full support | Guide | | Windsurf | ✅ Full support | Guide | | Continue | ✅ Full support | Guide |

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 Do MCP provides 40+ tools covering all major Fizzy operations:

| Category | Tools | |----------|-------| | Identity | fizzy_get_identity, fizzy_get_account | | Boards | fizzy_list_boards, fizzy_get_board, fizzy_create_board, fizzy_update_board, fizzy_delete_board, fizzy_publish_board, fizzy_unpublish_board | | Cards | fizzy_list_cards, fizzy_get_card, fizzy_create_card, fizzy_update_card, fizzy_delete_card, fizzy_close_card, fizzy_reopen_card, fizzy_postpone_card, fizzy_triage_card, fizzy_untriage_card, fizzy_tag_card, fizzy_assign_card, fizzy_watch_card, fizzy_unwatch_card, fizzy_pin_card, fizzy_unpin_card, fizzy_mark_golden, fizzy_unmark_golden | | Comments | fizzy_list_comments, fizzy_get_comment, fizzy_create_comment, fizzy_update_comment, fizzy_delete_comment | | Columns | fizzy_list_columns, fizzy_get_column, fizzy_create_column, fizzy_update_column, fizzy_delete_column | | Tags & Users | fizzy_list_tags, fizzy_list_users, fizzy_get_user |

See the Tools Reference for complete documentation.

CLI Commands

# Interactive setup wizard
npx fizzy-do-mcp configure

# Check current identity
npx fizzy-do-mcp whoami

# View configuration status
npx fizzy-do-mcp status

# Clear stored credentials
npx fizzy-do-mcp logout

# Run as MCP server (default)
npx fizzy-do-mcp

Architecture

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

Local vs Remote

| Feature | Local Server | Remote Server | |---------|--------------|---------------| | Privacy | Tokens stay on your machine | Tokens sent via HTTPS header | | Rate Limits | None | None | | Setup | Requires Node.js | Works anywhere | | Offline | Works offline after install | Requires internet | | Cost | Free | Free |

We recommend local for maximum privacy, but both options are fully supported and free.

Development

# Clone the repo
git clone https://github.com/ryanyogan/fizzy-do-mcp.git
cd fizzy-do-mcp

# Install dependencies
pnpm install

# Run checks (format, lint, typecheck)
pnpm check

# Run tests
pnpm test

# Build all packages
pnpm build

# 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 free at fizzy.do
• API Token - Generate from your Fizzy account settings
• MCP-Compatible Editor - Claude Desktop, Cursor, Claude Code, etc.

Getting Your API Token

1. Log in to Fizzy
2. Go to Account Settings → API Tokens
3. Click Generate New Token
4. Copy the token and use it during configuration

License

MIT

Credits

• Built for Claude and the Model Context Protocol
• Connects to Fizzy, Basecamp's task management tool
• Developed by Ryan Yogan