davegomez/fizzy-mcp

🏢 Workplace & Productivity
0 Views
0 Installs

📇 ☁️ - MCP server for Fizzy kanban task management with tools for boards, cards, comments, and checklists.

Quick Install

One-Click IDE Configuration
claude_desktop_config.json
{
  "mcpServers": {
    "davegomez-fizzy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "davegomez-fizzy-mcp"
      ]
    }
  }
}
Or

Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.

Documentation Overview

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.

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

VariableRequiredDefaultDescription
FIZZY_TOKENYes—API token from Fizzy settings
FIZZY_ACCOUNTNo—Default account slug (e.g., 897362094)
FIZZY_BASE_URLNohttps://app.fizzy.doAPI 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.

ParameterTypeRequiredDescription
action"get" | "set" | "list"YesAction to perform
account_slugstringFor setAccount 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.

ParameterTypeRequiredDefaultDescription
account_slugstringNoSession defaultAccount slug
limitnumberNo25Items per page (1-100)
cursorstringNo—Pagination cursor

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

fizzy_search

Searches for cards with filters.

ParameterTypeRequiredDescription
account_slugstringNoAccount slug
board_idstringNoFilter by board
tag_idsstring[]NoFilter by ALL tags
assignee_idsstring[]NoFilter by ANY assignees
creator_idsstring[]NoFilter by card creator
closer_idsstring[]NoFilter by who closed
card_idsstring[]NoFilter to specific card IDs
indexed_by"closed" | "not_now" | "all" | "stalled" | "postponing_soon" | "golden"NoFilter by index
assignment_status"unassigned"NoFilter by assignment status
sorted_by"newest" | "oldest" | "recently_active"NoSort order
termsstring[]NoFree-text search terms
creationdate range*NoFilter by creation date
closuredate range*NoFilter by closure date
limitnumberNoItems per page (1-100, default 25)
cursorstringNoPagination 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.

ParameterTypeRequiredDescription
account_slugstringNoAccount slug
card_numbernumberNo*Card number from URL (e.g., 42 from #42)
card_idstringNo*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.

ParameterTypeRequiredDescription
account_slugstringNoAccount slug
card_numbernumberNoCard to update (omit to create)
board_idstringCreate modeBoard for new card
titlestringCreate modeCard title
descriptionstringNoMarkdown content
status"open" | "closed" | "not_now"NoChange card status
column_idstringNoTriage to column
position"top" | "bottom"NoPosition in column (default: "bottom")
add_tagsstring[]NoTag titles to add
remove_tagsstring[]NoTag titles to remove
stepsstring[]NoChecklist items (create mode only)

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

fizzy_comment

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

ParameterTypeRequiredDescription
actionstringNo"create" (default), "list", "update", "delete"
account_slugstringNoAccount slug
card_numbernumberYesCard number
comment_idstringNoComment ID. Required for update/delete
bodystringNoComment 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.

ParameterTypeRequiredDescription
account_slugstringNoAccount slug
card_numbernumberYesCard containing the step
stepstring | numberNoContent substring OR 1-based index. Omit to create.
contentstringNoStep text for create or update
completedbooleanNoSet completion state
deletebooleanNoDelete 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"
  }
}
FieldTypeDescription
returnednumberItems in this response
has_morebooleanMore items available
next_cursorstringPass as cursor for next page

Error Reference

ErrorCause
"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

Related MCP Servers

6figr-com/jobgpt-mcp-server

📇 ☁️ 🏠 🍎 🪟 🐧 - MCP server for JobGPT — search jobs, auto-apply, generate tailored resumes, track applications, and find recruiters from any MCP client. 34 tools for job search, applications, resumes, and outreach.

🏢 Workplace & Productivity0 views
Agentled/mcp-server

📇 ☁️ - AI-native workflow orchestration with long-term memory, 100+ integrations, and unified credits. 32 MCP tools for building and running intelligent business workflows — lead enrichment, content publishing, company research, media production, and more. Knowledge Graph that learns across executions.

🏢 Workplace & Productivity0 views
alex13slem/openproject-codex-plugin

📇 ☁️ 🏠 🍎 🪟 🐧 - Write-capable MCP server for OpenProject API v3 with Community Edition support. Search, create, update, assign, prioritize, and comment on work packages. Published as io.github.alex13slem/openproject in the official MCP Registry and installable with npx -y openproject-codex-plugin.

🏢 Workplace & Productivity0 views
ap311036/ews-meeting-mcp

🐍 🏠 🍎 🪟 🐧 - Safely schedule Outlook meetings on on-prem Exchange EWS. Resolves attendees, discovers rooms, suggests slots, and requires preview-confirmed create/update/cancel writes with local credential handling and audit-friendly lifecycle records.

🏢 Workplace & Productivity0 views

Engagement

Views
0
Installs
0
Upvotes
0

Views and upvotes are unique per visitor network (hashed IP). Installs count copy actions.

Status

Health: Not checked yet

We have not completed a health check for this listing yet.

Last checked: 7/28/2026, 9:26:46 PM

Unclaimed listing (imported or pending owner verification). Claim it →
★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Links

View Repository

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Claim this listing

Promote this listing

Optional paid placement. Free listings stay free forever.

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.