Fizzy

Name: Fizzy
Author: davegomez

davegomez/fizzy-mcp

3 repo stars
Updated February 15, 2026
davegomez/fizzy-mcp

io.github.davegomez/fizzy is a MCP server that connects coding agents to Fizzy task management via API token auth.

About

io.github.davegomez/fizzy is a Model Context Protocol server that connects AI coding assistants to Fizzy task management. Developers who already run sprints in Fizzy can register the stdio server from npm (@silky/fizzy-mcp) and supply a FIZZY_TOKEN so agents can read and mutate tasks instead of copy-pasting status between chat and the board. You can point FIZZY_BASE_URL at another API endpoint and set FIZZY_ACCOUNT when you juggle multiple Fizzy workspaces. It fits the Build journey shelf under PM because shipping features and fixes is when task state changes most often, though you may keep it enabled through Ship for launch checklists. Complexity is beginner-friendly: one secret token and standard MCP client config. It is an integration layer, not a replacement for Fizzy’s UI or permissions model—your token still governs what the agent can touch.

stdio MCP package @silky/fizzy-mcp v1.0.0 with npm install path
Authenticates with required FIZZY_TOKEN secret env var
Optional FIZZY_BASE_URL for non-production or custom API hosts
Optional FIZZY_ACCOUNT slug for default workspace context
Task-management tools exposed over Model Context Protocol for agent-driven updates

Fizzy by the numbers

Data as of Jul 7, 2026 (Skillselion catalog sync)

terminal

claude mcp add --env FIZZY_TOKEN=YOUR_FIZZY_TOKEN --env FIZZY_BASE_URL=YOUR_FIZZY_BASE_URL --env FIZZY_ACCOUNT=YOUR_FIZZY_ACCOUNT fizzy -- npx -y @silky/fizzy-mcp

Add your badge

Show developers this MCP server is listed on Skillselion. Paste this into your README.

[![Listed on Skillselion](https://skillselion.com/badge/mcp/tool/io.github.davegomez/fizzy.svg)](https://skillselion.com/mcp/tool/io.github.davegomez/fizzy)

repo stars	★ 3
Package	@silky/fizzy-mcp
Transport	STDIO
Auth	Required
Last updated	February 15, 2026
Repository	davegomez/fizzy-mcp ↗

What it does

Let your coding agent list, create, and update tasks in Fizzy without leaving Claude Code or Cursor.

Who is it for?

Best when you already use Fizzy and want Claude Code or Cursor to create, assign, or close tasks while implementing features.

Skip if: Skip if you do not use Fizzy or anyone and needs deep reporting without granting API access via FIZZY_TOKEN.

What you get

Your agent can query and update Fizzy tasks in-thread so the board reflects the same priorities you are coding against.

Registered stdio MCP server pointing at Fizzy
Agent-callable Fizzy task operations scoped by your token
Optional multi-account routing via FIZZY_ACCOUNT and custom API base URL

By the numbers

server.schema.json version 1.0.0
npm package @silky/fizzy-mcp transport stdio
3 configurable environment variables (1 required secret)

README.md

fizzy-mcp

MCP server for Fizzy task management. Exposes 7 tools for managing boards, cards, comments, and checklists.

Prerequisites

Get your Fizzy access token:

Log in to Fizzy
Go to Settings > API Access
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.

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

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:

Explicit account_slug parameter on the tool call
Session default (set via fizzy_account tool with action: "set")
FIZZY_ACCOUNT environment variable
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
`account_slug`	string	No	Account slug
`board_id`	string	No	Filter by board
`tag_ids`	string[]	No	Filter by ALL tags
`assignee_ids`	string[]	No	Filter by ANY assignees
`creator_ids`	string[]	No	Filter by card creator
`closer_ids`	string[]	No	Filter by who closed
`card_ids`	string[]	No	Filter to specific card IDs
`indexed_by`	`"closed"` \| `"not_now"` \| `"all"` \| `"stalled"` \| `"postponing_soon"` \| `"golden"`	No	Filter by index
`assignment_status`	`"unassigned"`	No	Filter by assignment status
`sorted_by`	`"newest"` \| `"oldest"` \| `"recently_active"`	No	Sort order
`terms`	string[]	No	Free-text search terms
`creation`	date range*	No	Filter by creation date
`closure`	date range*	No	Filter by closure date
`limit`	number	No	Items per page (1-100, default 25)
`cursor`	string	No	Pagination cursor

*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.

Parameter	Type	Required	Description
`account_slug`	string	No	Account slug
`card_number`	number	No*	Card number from URL (e.g., `42` from `#42`)
`card_id`	string	No*	Card UUID from API responses

*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.

Parameter	Type	Required	Description
`account_slug`	string	No	Account slug
`card_number`	number	No	Card to update (omit to create)
`board_id`	string	Create mode	Board for new card
`title`	string	Create mode	Card title
`description`	string	No	Markdown content
`status`	`"open"` \| `"closed"` \| `"not_now"`	No	Change card status
`column_id`	string	No	Triage to column
`position`	`"top"` \| `"bottom"`	No	Position in column (default: `"bottom"`)
`add_tags`	string[]	No	Tag titles to add
`remove_tags`	string[]	No	Tag titles to remove
`steps`	string[]	No	Checklist items (create mode only)

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

fizzy_comment

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

Parameter	Type	Required	Description
`action`	string	No	`"create"` (default), `"list"`, `"update"`, `"delete"`
`account_slug`	string	No	Account slug
`card_number`	number	Yes	Card number
`comment_id`	string	No	Comment ID. Required for update/delete
`body`	string	No	Comment in markdown (1-10000 chars). Required for create/update

Returns: Comment object with id, body (markdown), creator, timestamps, url. List returns { comments, pagination }. Delete returns { comment_id, deleted }.

fizzy_step

Create, complete, update, uncomplete, or delete a step on a card.

Parameter	Type	Required	Description
`account_slug`	string	No	Account slug
`card_number`	number	Yes	Card containing the step
`step`	string \| number	No	Content substring OR 1-based index. Omit to create.
`content`	string	No	Step text for create or update
`completed`	boolean	No	Set completion state
`delete`	boolean	No	Delete the step

Mode detection:

step absent → CREATE (requires content)
step present, no other params → COMPLETE
step + content → UPDATE
step + completed: false → UNCOMPLETE
step + delete: true → DELETE

Returns: { "id": "...", "content": "...", "completed": true }

Pagination Reference

List operations return:

{
  "items": [...],
  "pagination": {
    "returned": 25,
    "has_more": true,
    "next_cursor": "opaque-cursor-string"
  }
}

Field	Type	Description
`returned`	number	Items in this response
`has_more`	boolean	More items available
`next_cursor`	string	Pass as `cursor` for next page

Error Reference

Error	Cause
"No account specified. Set FIZZY_ACCOUNT env var, use fizzy_account tool, or pass account_slug."	No account resolvable via any method
"Account "..." not found"	Invalid slug passed to `fizzy_account` set
"Card #N not found"	Card number does not exist
"Board not found"	Invalid `board_id`

License

AGPL-3.0-or-later

Recommended MCP Servers

0piFree, 2hr expiry agent storage to cache contexts, bridge workflows, or dump data.

100Hires AI ATS & Recruitment SoftwareOfficial 100Hires MCP: AI ATS & Recruitment Software for candidates, jobs, applications, interviews.

123elec McpInterface MCP officielle du site marchand 123elec, catalogue, stock, panier, commandes.

1stayHotel booking MCP server.2

2D Assets MCPMCP server for generating advanced mock 2D PNG assets for game prototypes.4

3D MeshWeaverMesh spatial optimizer reducing geometric overhead in 3D assets.

How it compares

Fizzy API MCP integration, not a standalone project-management skill or template repo.

FAQ

Who is io.github.davegomez/fizzy for?

Developers and small teams on Fizzy who want their AI coding agent to manage tasks through MCP instead of manual UI updates.

When should I use io.github.davegomez/fizzy?

Use it during active Build and Ship work when you want the agent to sync implementation progress with your Fizzy board in real time.

How do I add io.github.davegomez/fizzy to my agent?

Install @silky/fizzy-mcp from npm, add the stdio MCP server entry in Claude Code or Cursor, and set FIZZY_TOKEN plus optional FIZZY_BASE_URL and FIZZY_ACCOUNT.

Developer Toolspmworkflow