Skip to content
MCP server

Fizzy

MCP server giving AI clients access to Fizzy boards, cards, comments and checklists

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
1.0.0
Listing updated
today

Similar MCP servers

About Fizzy

Fizzy is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

The README describes fizzy-mcp as a Model Context Protocol server that lets an AI assistant work with Fizzy, a task management product. Once connected, a client can list boards, search cards with filters, read card details, create or update cards, and manage comments and checklist steps.

The server runs over stdio and is launched through npx from the @silky/fizzy-mcp npm package, or from a local build of the repository. Authentication uses a personal API token generated in Fizzy's settings. An account can be given through an environment variable, set per session with a dedicated tool, or auto-detected when the user has only one account.

It suits people who already track work in Fizzy and want an assistant such as Claude Desktop, Claude Code, Cursor or VS Code to read and update their boards without leaving the editor or chat. The code is licensed under AGPL-3.0-or-later.

Install

Run in a terminal

claude mcp add fizzy --env FIZZY_TOKEN='<FIZZY_TOKEN>' -- npx -y @silky/fizzy-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "fizzy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@silky/fizzy-mcp"
      ],
      "env": {
        "FIZZY_TOKEN": "<FIZZY_TOKEN>"
      }
    }
  }
}

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • FIZZY_TOKENFizzy API authentication tokenRequired
  • FIZZY_BASE_URLFizzy API base URL (defaults to production)
  • FIZZY_ACCOUNTDefault Fizzy account slug

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

fizzy_account
Gets, sets, or lists accounts for subsequent tool calls.
fizzy_boards
Lists boards in the account with column summaries.
fizzy_search
Searches for cards with filters.
fizzy_get_card
Gets full details of a card by number or ID.
fizzy_task
Creates or updates a card.
fizzy_comment
Create, list, update, or delete a comment on a card.
fizzy_step
Create, complete, update, uncomplete, or delete a step on a card.

What it does

Board and card search
Lists boards and searches cards by board, tags, assignees, status, dates and free text.
Card creation and updates
Creates cards with markdown descriptions, moves them between columns and changes their status.
Comment management
Creates, lists, edits and deletes markdown comments on a card.
Checklist steps
Adds, completes, renames, uncompletes and deletes checklist items on a card.
Multi-account support
Resolves the account from a call parameter, a session default, an environment variable or auto-detection.

Good for

  • Asking an assistant to list open cards on a Fizzy board
  • Creating tasks with checklists from a conversation in an AI client
  • Updating card status or adding comments while working in an editor
  • Searching recently active or unassigned cards across a board

Pricing

Open source

Free and open source under AGPL-3.0-or-later; uses a Fizzy account and API token.

Fizzy FAQ

How do I authenticate the server?

Generate an access token in Fizzy under Settings > API Access and pass it as the FIZZY_TOKEN environment variable.

Which AI clients are covered by the install instructions?

The README includes setup steps for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline and Continue, plus a build-from-source option.

What is the license?

The README states the license is AGPL-3.0-or-later.

Is Fizzy free?

Yes. Fizzy is open source, so you can use and self-host it for free.

How do I add Fizzy to Claude Code?

Run this command in your terminal: claude mcp add fizzy --env FIZZY_TOKEN='<FIZZY_TOKEN>' -- npx -y @silky/fizzy-mcp

What are the best alternatives to Fizzy?

The closest alternatives to Fizzy are Mewboard, craaft, Microsoft Todo MCP Server, Fjord and Decknote.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers