Fizzy

io.github.davegomez由 GitHub 帳號 davegomez 發布v1.0.0更新於 Oct 27, 2026

MCP server for Fizzy task management

已驗證STDIO僅桌面效率與工作流開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，把助理接入 Fizzy 任務管理，可瀏覽看板、搜尋卡片，並管理卡片、留言和檢查清單步驟。

可以做什麼
  • 列出帳戶中的看板及欄位摘要，支援分頁
  • 依看板、標籤、負責人、建立者、關閉者、索引、日期和關鍵字搜尋卡片
  • 依卡片編號或 ID 讀取卡片完整詳情
  • 建立或更新卡片，包括狀態、欄位、位置、標籤和檢查清單項目
  • 建立、列出、更新和刪除卡片留言
  • 建立、完成、更新、取消完成或刪除檢查清單步驟，並取得、設定或列出目前帳戶
適用情境
當你的任務放在 Fizzy，希望助理直接查看看板和卡片、依標籤或負責人或日期查找工作，並建立或更新卡片、留言和檢查清單項目而不必切換應用程式時適用。
執行需求
透過 npx 從 npm 套件 @silky/fizzy-mcp 在本機執行，需要 Node.js。需在 FIZZY_TOKEN 提供 Fizzy API 權杖，可於 Settings > API Access 產生。選用 FIZZY_ACCOUNT 設定預設帳戶 slug，FIZZY_BASE_URL 可覆寫 API 基礎位址。需要連線至 Fizzy 的網路。
安裝前請注意
Fizzy API 權杖屬於憑證，不要寫入共用設定檔，建議使用輸入提示或環境變數參照。此伺服器可建立、更新和刪除卡片、留言與步驟，助理操作會改動真實任務資料。任務內容會傳送到所設定基礎位址的 Fizzy API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Fizzy，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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
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:

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

Or add to ~/.claude.json:

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):

json
{  "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:

json
{  "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:

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
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:

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

Requires pnpm.

bash
git clone https://github.com/davegomez/fizzy-mcp.gitcd fizzy-mcppnpm installpnpm 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:

json
{  "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

來源：README.md，提交 c4dd809

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分