[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_116":117},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":-5,"_64":-5,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":-5,"_76":-5,"_77":-5,"_78":48,"_79":-5,"_80":81,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93},"apiUrl","https://odel.app/api","creator","davegomez","moduleId","fizzy-mcp","@davegomez/fizzy-mcp","displayName","fizzy mcp","tagline","MCP server for Fizzy task management","iconKey","https://avatars.githubusercontent.com/u/282903?v=4","category","local","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","pricingModel","free","creatorUserId","system:external-import","createdAt",1783338938000,"updatedAt",1788778680000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.davegomez%2Ffizzy","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",3,"upstreamUpdatedAt",1771178105000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/davegomez/fizzy-mcp","githubRepoFullName","davegomez/fizzy-mcp","releaseId","ext-davegomez-fizzy-mcp","version","1.0.0","descriptionMarkdown","# fizzy-mcp\n\nMCP server for [Fizzy](https://fizzy.do) task management. Exposes 7 tools for managing boards, cards, comments, and checklists.\n\n## Prerequisites\n\nGet your Fizzy access token:\n\n1. Log in to [Fizzy](https://app.fizzy.do)\n2. Go to Settings > API Access\n3. Generate a new token\n\n## How to Install\n\n

Claude Desktop

\n\nAdd to your config file:\n\n- **macOS:** `~/Library/Application\\ Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux:** `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n \"mcpServers\": {\n \"Fizzy\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@silky/fizzy-mcp\"],\n \"env\": {\n \"FIZZY_TOKEN\": \"your-token-here\"\n }\n }\n }\n}\n```\n\n**Windows only:** Add `\"APPDATA\": \"C:\\\\Users\\\\YourUsername\\\\AppData\\\\Roaming\"` to the `env` block.\n\nRestart Claude Desktop completely, then verify: \"List my Fizzy boards.\"\n\n

\n\n

Claude Code

\n\nUse the CLI:\n\n```bash\nclaude mcp add --transport stdio Fizzy --env FIZZY_TOKEN=your-token-here -- npx -y @silky/fizzy-mcp\n```\n\nOr add to `~/.claude.json`:\n\n```json\n{\n \"mcpServers\": {\n \"Fizzy\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@silky/fizzy-mcp\"],\n \"env\": {\n \"FIZZY_TOKEN\": \"your-token-here\"\n }\n }\n }\n}\n```\n\nRestart Claude Code, then verify: \"List my Fizzy boards.\"\n\n

\n\n

Cursor

\n\nAdd to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):\n\n```json\n{\n \"mcpServers\": {\n \"Fizzy\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@silky/fizzy-mcp\"],\n \"env\": {\n \"FIZZY_TOKEN\": \"your-token-here\"\n }\n }\n }\n}\n```\n\nRestart Cursor completely, then verify in Agent mode (Ctrl+I).\n\n

\n\n

VS Code

\n\nAdd to `.vscode/mcp.json` in your workspace:\n\n```json\n{\n \"inputs\": [\n {\n \"type\": \"promptString\",\n \"id\": \"fizzy-token\",\n \"description\": \"Fizzy API Token\",\n \"password\": true\n }\n ],\n \"servers\": {\n \"Fizzy\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@silky/fizzy-mcp\"],\n \"env\": {\n \"FIZZY_TOKEN\": \"${input:fizzy-token}\"\n }\n }\n }\n}\n```\n\nOr use user settings via Command Palette → \"MCP: Open User Configuration\".\n\n

\n\n

Windsurf

\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"Fizzy\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@silky/fizzy-mcp\"],\n \"env\": {\n \"FIZZY_TOKEN\": \"${env:FIZZY_TOKEN}\"\n }\n }\n }\n}\n```\n\nSet `FIZZY_TOKEN` in your shell environment, or hardcode the value. Restart Windsurf.\n\n

\n\n

Cline

\n\nAdd to the Cline MCP settings file:\n\n- **macOS:** `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`\n- **Windows:** `%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`\n- **Linux:** `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`\n\n```json\n{\n \"mcpServers\": {\n \"Fizzy\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@silky/fizzy-mcp\"],\n \"env\": {\n \"FIZZY_TOKEN\": \"your-token-here\"\n },\n \"disabled\": false,\n \"alwaysAllow\": []\n }\n }\n}\n```\n\n

\n\n

Continue

\n\nAdd to `.continue/config.yaml`:\n\n```yaml\nmcpServers:\n - name: Fizzy\n command: npx\n args:\n - \"-y\"\n - \"@silky/fizzy-mcp\"\n env:\n FIZZY_TOKEN: ${{ secrets.FIZZY_TOKEN }}\n```\n\n

\n\n

From Source

\n\n**Requires [pnpm](https://pnpm.io/).**\n\n```bash\ngit clone https://github.com/davegomez/fizzy-mcp.git\ncd fizzy-mcp\npnpm install\npnpm build\n```\n\nReplace `npx -y @silky/fizzy-mcp` with `node /absolute/path/to/fizzy-mcp/dist/index.js` in any config above.\n\n

\n\n---\n\n## Configuration Reference\n\n| Variable | Required | Default | Description |\n| ---------------- | -------- | ---------------------- | ---------------------------------------- |\n| `FIZZY_TOKEN` | Yes | — | API token from Fizzy settings |\n| `FIZZY_ACCOUNT` | No | — | Default account slug (e.g., `897362094`) |\n| `FIZZY_BASE_URL` | No | `https://app.fizzy.do` | API base URL |\n\n### Account Resolution\n\nTools resolve `account_slug` in this order:\n\n1. Explicit `account_slug` parameter on the tool call\n2. Session default (set via `fizzy_account` tool with `action: \"set\"`)\n3. `FIZZY_ACCOUNT` environment variable\n4. Auto-detect (if user has exactly one account)\n\n---\n\n## Tools Reference\n\n### fizzy_account\n\nGets, sets, or lists accounts for subsequent tool calls.\n\n| Parameter | Type | Required | Description |\n| -------------- | ------------------------------ | --------- | --------------------------- |\n| `action` | `\"get\"` \\| `\"set\"` \\| `\"list\"` | Yes | Action to perform |\n| `account_slug` | string | For `set` | Account slug from Fizzy URL |\n\n**Returns:**\n\n- `get`: `{ \"action\": \"get\", \"account_slug\": \"897362094\" | null }`\n- `set`: `{ \"action\": \"set\", \"account_slug\": \"897362094\" }`\n- `list`: `{ \"action\": \"list\", \"accounts\": [{ \"slug\": \"...\", \"name\": \"...\", \"id\": \"...\" }] }`\n\n---\n\n### fizzy_boards\n\nLists boards in the account with column summaries.\n\n| Parameter | Type | Required | Default | Description |\n| -------------- | ------ | -------- | --------------- | ---------------------- |\n| `account_slug` | string | No | Session default | Account slug |\n| `limit` | number | No | 25 | Items per page (1-100) |\n| `cursor` | string | No | — | Pagination cursor |\n\n**Returns:** `{ \"items\": Board[], \"pagination\": { \"returned\": number, \"has_more\": boolean, \"next_cursor\"?: string } }`\n\n---\n\n### fizzy_search\n\nSearches for cards with filters.\n\n| Parameter | Type | Required | Description |\n| ------------------- | ---------------------------------------------------------------------------------------- | -------- | ---------------------------------- |\n| `account_slug` | string | No | Account slug |\n| `board_id` | string | No | Filter by board |\n| `tag_ids` | string[] | No | Filter by ALL tags |\n| `assignee_ids` | string[] | No | Filter by ANY assignees |\n| `creator_ids` | string[] | No | Filter by card creator |\n| `closer_ids` | string[] | No | Filter by who closed |\n| `card_ids` | string[] | No | Filter to specific card IDs |\n| `indexed_by` | `\"closed\"` \\| `\"not_now\"` \\| `\"all\"` \\| `\"stalled\"` \\| `\"postponing_soon\"` \\| `\"golden\"` | No | Filter by index |\n| `assignment_status` | `\"unassigned\"` | No | Filter by assignment status |\n| `sorted_by` | `\"newest\"` \\| `\"oldest\"` \\| `\"recently_active\"` | No | Sort order |\n| `terms` | string[] | No | Free-text search terms |\n| `creation` | date range\\* | No | Filter by creation date |\n| `closure` | date range\\* | No | Filter by closure date |\n| `limit` | number | No | Items per page (1-100, default 25) |\n| `cursor` | string | No | Pagination cursor |\n\n\\*Date range values: `today`, `yesterday`, `thisweek`, `thismonth`, `last7`, `last14`, `last30`.\n\n**Returns:** `{ \"items\": Card[], \"pagination\": {...} }`\n\n---\n\n### fizzy_get_card\n\nGets full details of a card by number or ID.\n\n| Parameter | Type | Required | Description |\n| -------------- | ------ | -------- | -------------------------------------------- |\n| `account_slug` | string | No | Account slug |\n| `card_number` | number | No\\* | Card number from URL (e.g., `42` from `#42`) |\n| `card_id` | string | No\\* | Card UUID from API responses |\n\n\\*Provide `card_number` OR `card_id`. Prefer `card_number` when you have the human-readable `#` from the UI.\n\n**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.\n\n---\n\n### fizzy_task\n\nCreates or updates a card.\n\n**Mode:** Omit `card_number` to create; include it to update.\n\n| Parameter | Type | Required | Description |\n| -------------- | ------------------------------------- | ----------- | ---------------------------------------- |\n| `account_slug` | string | No | Account slug |\n| `card_number` | number | No | Card to update (omit to create) |\n| `board_id` | string | Create mode | Board for new card |\n| `title` | string | Create mode | Card title |\n| `description` | string | No | Markdown content |\n| `status` | `\"open\"` \\| `\"closed\"` \\| `\"not_now\"` | No | Change card status |\n| `column_id` | string | No | Triage to column |\n| `position` | `\"top\"` \\| `\"bottom\"` | No | Position in column (default: `\"bottom\"`) |\n| `add_tags` | string[] | No | Tag titles to add |\n| `remove_tags` | string[] | No | Tag titles to remove |\n| `steps` | string[] | No | Checklist items (create mode only) |\n\n**Returns:** `{ \"mode\": \"create\" | \"update\", \"card\": {...}, \"operations\": {...}, \"failures\": [...] }`\n\n---\n\n### fizzy_comment\n\nCreate, list, update, or delete a comment on a card.\n\n| Parameter | Type | Required | Description |\n| -------------- | ------ | -------- | --------------------------------------------------------------- |\n| `action` | string | No | `\"create\"` (default), `\"list\"`, `\"update\"`, `\"delete\"` |\n| `account_slug` | string | No | Account slug |\n| `card_number` | number | Yes | Card number |\n| `comment_id` | string | No | Comment ID. Required for update/delete |\n| `body` | string | No | Comment in markdown (1-10000 chars). Required for create/update |\n\n**Returns:** Comment object with `id`, `body` (markdown), `creator`, timestamps, `url`. List returns `{ comments, pagination }`. Delete returns `{ comment_id, deleted }`.\n\n---\n\n### fizzy_step\n\nCreate, complete, update, uncomplete, or delete a step on a card.\n\n| Parameter | Type | Required | Description |\n| -------------- | ---------------- | -------- | --------------------------------------------------- |\n| `account_slug` | string | No | Account slug |\n| `card_number` | number | Yes | Card containing the step |\n| `step` | string \\| number | No | Content substring OR 1-based index. Omit to create. |\n| `content` | string | No | Step text for create or update |\n| `completed` | boolean | No | Set completion state |\n| `delete` | boolean | No | Delete the step |\n\n**Mode detection:**\n\n- `step` absent → CREATE (requires `content`)\n- `step` present, no other params → COMPLETE\n- `step` + `content` → UPDATE\n- `step` + `completed: false` → UNCOMPLETE\n- `step` + `delete: true` → DELETE\n\n**Returns:** `{ \"id\": \"...\", \"content\": \"...\", \"completed\": true }`\n\n---\n\n## Pagination Reference\n\nList operations return:\n\n```json\n{\n \"items\": [...],\n \"pagination\": {\n \"returned\": 25,\n \"has_more\": true,\n \"next_cursor\": \"opaque-cursor-string\"\n }\n}\n```\n\n| Field | Type | Description |\n| ------------- | ------- | ------------------------------ |\n| `returned` | number | Items in this response |\n| `has_more` | boolean | More items available |\n| `next_cursor` | string | Pass as `cursor` for next page |\n\n---\n\n## Error Reference\n\n| Error | Cause |\n| ------------------------------------------------------------------------------------------------ | ------------------------------------------ |\n| \"No account specified. Set FIZZY_ACCOUNT env var, use fizzy_account tool, or pass account_slug.\" | No account resolvable via any method |\n| \"Account \\\"...\\\" not found\" | Invalid slug passed to `fizzy_account` set |\n| \"Card #N not found\" | Card number does not exist |\n| \"Board not found\" | Invalid `board_id` |\n\n---\n\n## License\n\nAGPL-3.0-or-later\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_99":100,"_101":102,"_103":104,"_105":106,"_107":-5,"_108":109},"requiredSecrets",[],"tags",[96,97,98],"assets",[],"stats",{"_94":81,"_95":81},"ratingAvg","reviewCount","ai-tools","fizzy","kanban","topics",[96,97,98,115],"license","AGPL-3.0","language","TypeScript","registryName","io.github.davegomez/fizzy","homepage","packages",[110],{"_111":112,"_113":114,"_71":72},"registryType","npm","identifier","@silky/fizzy-mcp","mcp","ENV",{"_118":119,"_120":121,"_122":123},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]