Fizzy MCP

Name: Fizzy MCP
Author: davegomez

ローカル

github.com/davegomez生産性337 週間前に更新

リポジトリ

Fizzy MCP について

Fizzy MCPは、MCPクライアントからタスク管理サービスFizzyを操作するMCPサーバーです。ボードやカードの管理に加え、条件付き検索、コメント、チェックリストの操作に対応します。

主な機能

01アカウントとボードの一覧表示
02条件を指定したカード検索
03カード詳細の取得
04カードの作成と更新
05カードコメントの管理
06チェックリスト項目の管理

活用シーン

01ボード、担当者、状態でカードを検索
02タスクカードを作成または更新
03カードコメントを確認・編集
04チェックリストの完了状況を追跡

MCP 対応

7種類のMCPツールを通じて、Fizzyのアカウント、ボード、カード、コメント、チェックリストを操作できます。

#task-management #kanban #productivity #fizzy

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

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

起動コマンドnpx -y @silky/fizzy-mcp

設定が必要な環境変数

FIZZY_TOKENシークレットFizzy API authentication token

FIZZY_BASE_URLFizzy API base URL (defaults to production)

FIZZY_ACCOUNTDefault Fizzy account slug

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@silky/fizzy-mcp1.0.0stdio

ツール

掲載時のツール一覧 · 3 週間前に更新

パラメーター	型	必須	説明
action	enum	はい	操作：get（取得）\| set（設定）\| list（一覧表示）。現在の値を確認するには 'get' を、変更するには 'set' を、利用可能な項目を確認するには 'list' を使用します。get \| set \| list
account_slug	string	いいえ	アカウントの slug（set 操作では必須）。

詳細

fizzy-mcp

Fizzy のタスク管理用 MCP サーバーです。ボード、カード、コメント、チェックリストを管理するための 7 つのツールを提供します。

前提条件

Fizzy のアクセストークンを取得します。

Fizzy にログインします
Settings > API Access に移動します
新しいトークンを生成します

インストール方法

Claude Desktop

設定ファイルに追加します。

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 のみ: env ブロックに "APPDATA": "C:\\Users\\YourUsername\\AppData\\Roaming" を追加します。

Claude Desktop を完全に再起動し、「Fizzy のボードを一覧表示して」と入力して確認します。

Claude Code

CLI を使用します。

claude mcp add --transport stdio Fizzy --env FIZZY_TOKEN=your-token-here -- npx -y @silky/fizzy-mcp

または、~/.claude.json に追加します。

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

Claude Code を再起動し、「Fizzy のボードを一覧表示して」と入力して確認します。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に追加します。

{
  "mcpServers": {
    "Fizzy": {
      "command": "npx",
      "args": ["-y", "@silky/fizzy-mcp"],
      "env": {
        "FIZZY_TOKEN": "your-token-here"
      }
    }
  }
}

Cursor を完全に再起動し、Agent モード（Ctrl+I）で確認します。

VS Code

ワークスペースの .vscode/mcp.json に追加します。

{
  "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}"
      }
    }
  }
}

または、コマンドパレットから「MCP: Open User Configuration」を選択してユーザー設定を使用します。

Windsurf

~/.codeium/windsurf/mcp_config.json に追加します。

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

シェル環境で FIZZY_TOKEN を設定するか、値を直接記述します。Windsurf を再起動します。

Cline

Cline の MCP 設定ファイルに追加します。

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

.continue/config.yaml に追加します。

mcpServers:
  - name: Fizzy
    command: npx
    args:
      - "-y"
      - "@silky/fizzy-mcp"
    env:
      FIZZY_TOKEN: ${{ secrets.FIZZY_TOKEN }}

ソースからインストール

pnpm が必要です。

git clone https://github.com/davegomez/fizzy-mcp.git
cd fizzy-mcp
pnpm install
pnpm build

上記の設定で npx -y @silky/fizzy-mcp を node /absolute/path/to/fizzy-mcp/dist/index.js に置き換えます。

設定リファレンス

変数	必須	デフォルト	説明
`FIZZY_TOKEN`	はい	—	Fizzy の設定画面で取得した API トークン
`FIZZY_ACCOUNT`	いいえ	—	デフォルトのアカウントスラッグ（例：`897362094`）
`FIZZY_BASE_URL`	いいえ	`https://app.fizzy.do`	API のベース URL

アカウントの解決

ツールは次の順序で account_slug を解決します。

ツール呼び出しで明示的に指定した account_slug パラメーター
セッションのデフォルト（action: "set" を指定して fizzy_account ツールで設定）
FIZZY_ACCOUNT 環境変数
自動検出（ユーザーのアカウントが 1 つだけの場合）

ツールリファレンス

fizzy_account

以降のツール呼び出しで使用するアカウントを取得、設定、または一覧表示します。

パラメーター	型	必須	説明
`action`	`"get"` \| `"set"` \| `"list"`	はい	実行するアクション
`account_slug`	string	`set` の場合	Fizzy の URL にあるアカウントスラッグ

戻り値：

get: { "action": "get", "account_slug": "897362094" | null }
set: { "action": "set", "account_slug": "897362094" }
list: { "action": "list", "accounts": [{ "slug": "...", "name": "...", "id": "..." }] }

fizzy_boards

アカウント内のボードを、列の概要とともに一覧表示します。

Parameter	Type	Required	Default	Description
`account_slug`	string	No	Session default	アカウントのスラッグ
`limit`	number	No	25	1 ページあたりの項目数（1～100）
`cursor`	string	No	—	ページネーションカーソル

Returns: { "items": Board[], "pagination": { "returned": number, "has_more": boolean, "next_cursor"?: string } }

fizzy_search

フィルターを指定してカードを検索します。

Parameter	Type	Required	Description
`account_slug`	string	No	アカウントのスラッグ
`board_id`	string	No	ボードで絞り込み
`tag_ids`	string[]	No	すべてのタグで絞り込み
`assignee_ids`	string[]	No	いずれかの担当者で絞り込み
`creator_ids`	string[]	No	カードの作成者で絞り込み
`closer_ids`	string[]	No	カードをクローズしたユーザーで絞り込み
`card_ids`	string[]	No	特定のカード ID に絞り込み
`indexed_by`	`"closed"` \| `"not_now"` \| `"all"` \| `"stalled"` \| `"postponing_soon"` \| `"golden"`	No	インデックスで絞り込み
`assignment_status`	`"unassigned"`	No	割り当てステータスで絞り込み
`sorted_by`	`"newest"` \| `"oldest"` \| `"recently_active"`	No	並べ替え順
`terms`	string[]	No	フリーテキスト検索語
`creation`	date range*	No	作成日で絞り込み
`closure`	date range*	No	クローズ日で絞り込み
`limit`	number	No	1 ページあたりの項目数（1～100、既定値 25）
`cursor`	string	No	ページネーションカーソル

*日付範囲の値：today、yesterday、thisweek、thismonth、last7、last14、last30。

Returns: { "items": Card[], "pagination": {...} }

fizzy_get_card

カード番号または ID でカードの詳細を取得します。

パラメーター	型	必須	説明
`account_slug`	string	いいえ	アカウントのスラッグ
`card_number`	number	いいえ*	URL のカード番号（例：`#42` の `42`）
`card_id`	string	いいえ*	API レスポンスのカード UUID

*card_number または card_id のいずれかを指定してください。UI で人が読み取れる # の番号が分かる場合は、card_number を推奨します。

戻り値： id、number、title、description（Markdown）、status、board_id、column_id、tags、assignees、steps_count、completed_steps_count、comments_count、url、タイムスタンプを含むカードオブジェクト。

fizzy_task

カードを作成または更新します。

モード： 作成する場合は card_number を省略し、更新する場合は指定します。

パラメーター	型	必須	説明
`account_slug`	string	いいえ	アカウントのスラッグ
`card_number`	number	いいえ	更新するカード（作成時は省略）
`board_id`	string	作成モード	新しいカードのボード
`title`	string	作成モード	カードのタイトル
`description`	string	いいえ	Markdown コンテンツ
`status`	`"open"` \| `"closed"` \| `"not_now"`	いいえ	カードのステータスを変更
`column_id`	string	いいえ	列に振り分け
`position`	`"top"` \| `"bottom"`	いいえ	列内の位置（デフォルト：`"bottom"`）
`add_tags`	string[]	いいえ	追加するタグのタイトル
`remove_tags`	string[]	いいえ	削除するタグのタイトル
`steps`	string[]	いいえ	チェックリスト項目（作成モードのみ）

戻り値： { "mode": "create" | "update", "card": {...}, "operations": {...}, "failures": [...] }

fizzy_comment

カードのコメントを作成、一覧表示、更新、または削除します。

パラメーター	型	必須	説明
`action`	string	いいえ	`"create"`（デフォルト）、`"list"`、`"update"`、`"delete"`
`account_slug`	string	いいえ	アカウントのスラッグ
`card_number`	number	はい	カード番号
`comment_id`	string	いいえ	コメント ID。更新または削除時に必須
`body`	string	いいえ	Markdown 形式のコメント（1～10000 文字）。作成または更新時に必須

戻り値： id、body（Markdown）、creator、タイムスタンプ、url を含むコメントオブジェクト。一覧表示では { comments, pagination } を返します。削除では { comment_id, deleted } を返します。

fizzy_step

カードのステップを作成、完了、更新、未完了にする、または削除します。

パラメーター	型	必須	説明
`account_slug`	string	いいえ	アカウントのスラッグ
`card_number`	number	はい	ステップを含むカード
`step`	string \| number	いいえ	内容の部分文字列または1始まりのインデックス。省略すると作成します。
`content`	string	いいえ	作成または更新するステップのテキスト
`completed`	boolean	いいえ	完了状態を設定
`delete`	boolean	いいえ	ステップを削除

モードの判定：

step がない → CREATE（content が必要）
step があり、ほかのパラメーターがない → COMPLETE
step + content → UPDATE
step + completed: false → UNCOMPLETE
step + delete: true → DELETE

戻り値： { "id": "...", "content": "...", "completed": true }

ページネーションのリファレンス

一覧取得操作の戻り値：

{
  "items": [...],
  "pagination": {
    "returned": 25,
    "has_more": true,
    "next_cursor": "opaque-cursor-string"
  }
}

フィールド	型	説明
`returned`	number	このレスポンスに含まれる項目数
`has_more`	boolean	取得可能な項目がほかにもあるか
`next_cursor`	string	次のページの `cursor` として渡します

エラーのリファレンス

エラー	原因
"No account specified. Set FIZZY_ACCOUNT env var, use fizzy_account tool, or pass account_slug."	いずれの方法でもアカウントを解決できません
"Account "..." not found"	`fizzy_account` に渡されたスラッグが無効です
"Card #N not found"	カード番号が存在しません
"Board not found"	`board_id` が無効です

ライセンス

AGPL-3.0-or-later

Markdown 対応

ログインしてコメント

基本情報

ライセンス: AGPL-3.0
作者: davegomez
言語: node
バージョン: 1.0.0
トランスポート: stdio
掲載日: 2026年2月1日
最終更新: 37 週間前
公式 Registry: io.github.davegomez/fizzy

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。