How do I use fizzy-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@fizzy-mcp create a card titled 'Update API docs' on the Documentation board" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

fizzy-mcp

MCP server for Fizzy — the Kanban tool by 37signals.

Lets AI assistants (Claude, etc.) read and manage your Fizzy boards, cards, columns, tags, comments and more.

Quick start

1. Get your Fizzy access token

Go to your Fizzy profile → Developer → Personal access tokens → Generate new access token with Read + Write permission.

Find your account slug — it's the number in your Fizzy URL: app.fizzy.do/<account_slug>/boards.

2. Configure

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "fizzy": {
      "command": "uvx",
      "args": ["fizzy-mcp"],
      "env": {
        "FIZZY_ACCESS_TOKEN": "your-token-here",
        "FIZZY_ACCOUNT_SLUG": "your-slug-here"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "fizzy": {
      "command": "uvx",
      "args": ["fizzy-mcp"],
      "env": {
        "FIZZY_ACCESS_TOKEN": "your-token-here",
        "FIZZY_ACCOUNT_SLUG": "your-slug-here"
      }
    }
  }
}

Available tools

Boards

Tool	Description
`list_boards`	List all boards
`get_board`	Get a specific board
`create_board`	Create a new board
`update_board`	Update board name, access, auto-postpone
`delete_board`	Delete a board

Columns

Tool	Description
`list_columns`	List columns on a board
`create_column`	Create a column with name and color
`update_column`	Update column name or color
`delete_column`	Delete a column

Cards

Tool	Description
`list_cards`	List cards with filters (board, tags, assignees, status, dates, search)
`get_card`	Get a card by number
`create_card`	Create a card with title, description (HTML), tags
`update_card`	Update card title, description, tags
`delete_card`	Delete a card
`close_card`	Mark a card as done
`reopen_card`	Reopen a closed card
`triage_card`	Move a card into a column
`untriage_card`	Send a card back to triage
`postpone_card`	Move a card to Not Now
`mark_golden`	Star a card
`unmark_golden`	Unstar a card

Assignments

Tool	Description
`toggle_assignment`	Assign/unassign a user to a card
`self_assign`	Assign yourself to a card

Comments

Tool	Description
`list_comments`	List comments on a card
`get_comment`	Get a specific comment
`create_comment`	Add a comment (supports HTML)
`update_comment`	Edit a comment
`delete_comment`	Delete a comment

Reactions

Tool	Description
`list_reactions`	List reactions on a card
`add_reaction`	Add a reaction/boost (max 16 chars)
`remove_reaction`	Remove a reaction

Steps (to-dos)

Tool	Description
`create_step`	Add a to-do step to a card
`update_step`	Update step text or mark complete
`delete_step`	Delete a step

Users

Tool	Description
`list_users`	List active users
`get_user`	Get a specific user

Notifications

Tool	Description
`list_notifications`	List your notifications
`mark_notification_read`	Mark one as read
`mark_notification_unread`	Mark one as unread
`mark_all_notifications_read`	Mark all as read

Pins & Watch

Tool	Description
`list_pins`	List your pinned cards
`pin_card` / `unpin_card`	Pin or unpin a card
`watch_card` / `unwatch_card`	Subscribe/unsubscribe from card notifications

Identity

Tool	Description
`get_identity`	Get current user and accounts

Development

git clone https://github.com/alexrbzz/fizzy-mcp.git
cd fizzy-mcp
pip install -e .
FIZZY_ACCESS_TOKEN=xxx FIZZY_ACCOUNT_SLUG=123 fizzy-mcp

License

MIT

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tool	Description
`list_tags`	List all tags
`toggle_tag`	Toggle a tag on/off for a card

fizzy-mcp

fizzy-mcp

Quick start

1. Get your Fizzy access token

2. Configure

Claude Code

Claude Desktop

Available tools

Boards

Columns

Cards

Tags

Assignments

Comments

Reactions

Steps (to-dos)

Users

Notifications

Pins & Watch

Identity

Development

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API