davegomez/fizzy-mcp

MCP server for Fizzy task management. Exposes 7 tools for managing boards, cards, comments, and checklists.
Prerequisites
Get your Fizzy access token:
1. Log in to Fizzy
2. Go to Settings > API Access
3. Generate a new token
How to Install
Claude Desktop
Add to your config file:
- **macOS:** ~/Library/Application\ Support/Claude/claude_desktop_config.json
- **Windows:** %APPDATA%\Claude\claude_desktop_config.json
- **Linux:** ~/.config/Claude/claude_desktop_config.json
**Windows only:** Add "APPDATA": "C:\\Users\\YourUsername\\AppData\\Roaming" to the env block.
Restart Claude Desktop completely, then verify: "List my Fizzy boards."
Claude Code
Use the CLI:
Or add to ~/.claude.json:
Restart Claude Code, then verify: "List my Fizzy boards."
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
Restart Cursor completely, then verify in Agent mode (Ctrl+I).
VS Code
Add to .vscode/mcp.json in your workspace:
Or use user settings via Command Palette → "MCP: Open User Configuration".
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
Set FIZZY_TOKEN in your shell environment, or hardcode the value. Restart Windsurf.
Cline
Add to the Cline MCP settings file:
- **macOS:** ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- **Windows:** %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- **Linux:** ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
Continue
Add to .continue/config.yaml:
From Source
**Requires pnpm.**
Replace npx -y @silky/fizzy-mcp with node /absolute/path/to/fizzy-mcp/dist/index.js in any config above.
---
Configuration Reference
| Variable | Required | Default | Description |
| ---------------- | -------- | ---------------------- | ---------------------------------------- |
| FIZZY_TOKEN | Yes | — | API token from Fizzy settings |
| FIZZY_ACCOUNT | No | — | Default account slug (e.g., 897362094) |
| FIZZY_BASE_URL | No | https://app.fizzy.do | API base URL |
Account Resolution
Tools resolve account_slug in this order:
1. Explicit account_slug parameter on the tool call
2. Session default (set via fizzy_account tool with action: "set")
3. FIZZY_ACCOUNT environment variable
4. Auto-detect (if user has exactly one account)
---
Tools Reference
fizzy_account
Gets, sets, or lists accounts for subsequent tool calls.
| Parameter | Type | Required | Description |
| -------------- | ------------------------------ | --------- | --------------------------- |
| action | "get" \| "set" \| "list" | Yes | Action to perform |
| account_slug | string | For set | Account slug from Fizzy URL |
**Returns:**
- get: { "action": "get", "account_slug": "897362094" | null }
- set: { "action": "set", "account_slug": "897362094" }
- list: { "action": "list", "accounts": [{ "slug": "...", "name": "...", "id": "..." }] }
---
fizzy_boards
Lists boards in the account with column summaries.
| Parameter | Type | Required | Default | Description |
| -------------- | ------ | -------- | --------------- | ---------------------- |
| account_slug | string | No | Session default | Account slug |
| limit | number | No | 25 | Items per page (1-100) |
| cursor | string | No | — | Pagination cursor |
**Returns:** { "items": Board[], "pagination": { "returned": number, "has_more": boolean, "next_cursor"?: string } }
---
fizzy_search
Searches for cards with filters.
| Parameter | Type | Required | Description |
| ------------------- | ---------------------------------------------------------------------------------------- | -------- | ---------------------------------- |