MCP server for Fizzy kanban task management
fizzy-mcp
MCP server for Fizzy task management. Exposes 7 tools for managing boards, cards, comments, and checklists.
Prerequisites
Get your Fizzy access token:
- Log in to Fizzy
- Go to Settings > API Access
- 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
{
"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:
claude mcp add --transport stdio Fizzy --env FIZZY_TOKEN=your-token-here -- npx -y @silky/fizzy-mcp
Or add to ~/.claude.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):
{
"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:
{
"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:
{
"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
{
"mcpServers": {
"Fizzy": {
"command": "npx",
"args": ["-y", "@silky/fizzy-mcp"],
"env": {
"FIZZY_TOKEN": "your-token-here"
},
"disabled": false,
"alwaysAllow": []
}
}
}
Continue
Add to .continue/config.yaml:
mcpServers:
- name: Fizzy
command: npx
args:
- "-y"
- "@silky/fizzy-mcp"
env:
FIZZY_TOKEN: ${{ secrets.FIZZY_TOKEN }}
From Source
Requires pnpm.
git clone https://github.com/davegomez/fizzy-mcp.git
cd fizzy-mcp
pnpm install
pnpm build
Replace npx -y @silky/fizzy-mcp with node /absolute/path/to/fizzy-mcp/dist/index.js in any config above.
Configuration Reference
| Variable | Required | Default | Description |
|---|---|---|---|
FIZZY_TOKEN |
Yes | — | API token from Fizzy settings |
FIZZY_ACCOUNT |
No | — | Default account slug (e.g., 897362094) |
FIZZY_BASE_URL |
No | https://app.fizzy.do |
API base URL |
Account Resolution
Tools resolve account_slug in this order:
- Explicit
account_slugparameter on the tool call - Session default (set via
fizzy_accounttool withaction: "set") FIZZY_ACCOUNTenvironment variable- Auto-detect (if user has exactly one account)
Tools Reference
fizzy_account
Gets, sets, or lists accounts for subsequent tool calls.
| Parameter | Type | Required | Description | | -------------- | -------------
Tools (1)
fizzy_accountGets, sets, or lists accounts for subsequent tool calls.Environment Variables
FIZZY_TOKENrequiredAPI token from Fizzy settingsFIZZY_ACCOUNTDefault account slugFIZZY_BASE_URLAPI base URLConfiguration
{"mcpServers": {"Fizzy": {"command": "npx", "args": ["-y", "@silky/fizzy-mcp"], "env": {"FIZZY_TOKEN": "your-token-here"}}}}