# Fizzy

> Fizzy is an open-source MCP server for productivity. MCP server giving AI clients access to Fizzy boards, cards, comments and checklists. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/davegomez/fizzy-mcp
- **MCP Registry name:** io.github.davegomez/fizzy
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

## Alternatives

- [Mewboard](https://ai-powered.com/mcp/mewboard): Mewboard is a paid MCP server for productivity.
- [craaft](https://ai-powered.com/mcp/craaft): craaft is a freemium MCP server for productivity.
- [Microsoft Todo MCP Server](https://ai-powered.com/mcp/microsoft-todo-mcp-server): Microsoft Todo MCP Server is an open-source MCP server for productivity.
- [Fjord](https://ai-powered.com/mcp/fjord): Fjord is an open-source MCP server for developer tools.
- [Decknote](https://ai-powered.com/mcp/decknote): Decknote is a freemium MCP server for productivity.
- [Plaky MCP by usefulapi](https://ai-powered.com/mcp/plaky-mcp-by-usefulapi): Plaky MCP by usefulapi is a freemium MCP server for productivity.
- [MCP Microsoft Todo](https://ai-powered.com/mcp/mcp-microsoft-todo): MCP Microsoft Todo is an open-source MCP server for productivity.
- [Glidely](https://ai-powered.com/mcp/glidely): Glidely is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/fizzy
