Fizzy

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

{

"mcpServers": { "Fizzy": { "command": "npx", "args": ["-y", "@silky/fizzy-mcp"], "env": { "FIZZY_TOKEN": "your-token-here" } } } }

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:

claude mcp add --transport stdio Fizzy --env FIZZY_TOKEN=your-token-here -- npx -y @silky/fizzy-mcp

Or add to ~/.claude.json:

{

"mcpServers": { "Fizzy": { "command": "npx", "args": ["-y", "@silky/fizzy-mcp"], "env": { "FIZZY_TOKEN": "your-token-here" } } } }

Restart Claude Code, then verify: "List my Fizzy boards."

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{

"mcpServers": { "Fizzy": { "command": "npx", "args": ["-y", "@silky/fizzy-mcp"], "env": { "FIZZY_TOKEN": "your-token-here" } } } }

Restart Cursor completely, then verify in Agent mode (Ctrl+I).

VS Code

Add to .vscode/mcp.json in your workspace:

{

"inputs": [ { "type": "promptString", "id": "fizzy-token", "description": "Fizzy API Token", "password": true } ], "servers": { "Fizzy": { "command": "npx", "args": ["-y", "@silky/fizzy-mcp"], "env": { "FIZZY_TOKEN": "${input:fizzy-token}" } } } }

Or use user settings via Command Palette → "MCP: Open User Configuration".

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "Fizzy": { "command": "npx", "args": ["-y", "@silky/fizzy-mcp"], "env": { "FIZZY_TOKEN": "${env:FIZZY_TOKEN}" } } } }

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

{

"mcpServers": { "Fizzy": { "command": "npx", "args": ["-y", "@silky/fizzy-mcp"], "env": { "FIZZY_TOKEN": "your-token-here" }, "disabled": false, "alwaysAllow": [] } } }

Continue

Add to .continue/config.yaml:

mcpServers:

• name: Fizzy command: npx args:
• "-y"
• "@silky/fizzy-mcp" env: FIZZY_TOKEN: ${{ secrets.FIZZY_TOKEN }}

From Source

Requires [pnpm](https://pnpm.io/).

git clone https://github.com/davegomez/fizzy-mcp.git

cd fizzy-mcp pnpm install pnpm build

Replace npx -y @silky/fizzy-mcp with node /absolute/path/to/fizzy-mcp/dist/index.js in any config above.

---

Configuration Reference

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.

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.

Returns: { "items": Board[], "pagination": { "returned": number, "has_more": boolean, "next_cursor"?: string } }

---

fizzy_search

Searches for cards with filters.

\*Date range values: today, yesterday, thisweek, thismonth, last7, last14, last30.

Returns: { "items": Card[], "pagination": {...} }

---

fizzy_get_card

Gets full details of a card by number or ID.

\*Provide card_number OR card_id. Prefer card_number when you have the human-readable # from the UI.

Returns: Card object with id, number, title, description (markdown), status, board_id, column_id, tags, assignees, steps_count, completed_steps_count, comments_count, url, timestamps.

---

fizzy_task

Creates or updates a card.

Mode: Omit card_number to create; include it to update.

Returns: { "mode": "create" | "update", "card": {...}, "operations": {...}, "failures": [...] }

---

fizzy_comment

Create, list, update, or delete a comment on a card.

| action | string | No | "create" (default), "list", "update", `"