easy-backlog-tools

easy-backlog の課題を操作できる MCP サーバー + CLI ツール。

Claude Desktop から MCP で使う場合と、ターミナル・AI エージェントから CLI で使う場合の両方に対応。

インストール

npm install -g easy-backlog-tools

セットアップ

DATABASE_URL の設定

Supabase プロジェクトの Transaction Pooler URL を環境変数に設定する：

export DATABASE_URL="postgresql://postgres.<project-id>:<password>@aws-1-ap-northeast-1.pooler.supabase.com:6543/postgres"

DATABASE_URL が未設定の場合について MCP サーバーは起動自体は成功するが、各ツールを呼び出すと接続先が不明なため操作できない旨のエラーが返される。 Claude Desktop は起動時に MCP サーバーを立ち上げるが、その時点では環境変数が読み込まれていないケースがある。 .zshrc などに export DATABASE_URL=... を追記した後、Claude Desktop を再起動することで反映される。

接続確認：

easy-backlog-tools

MCP サーバー（Claude Desktop）

設定

~/Library/Application Support/Claude/claude_desktop_config.json を編集：

{
  "mcpServers": {
    "easy-backlog": {
      "command": "npx",
      "args": ["-y", "easy-backlog-tools@latest", "--mcp"]
    }
  }
}

DATABASE_URL は .zshrc などで設定済みであれば env フィールドは不要。

使えるツール

| ツール名 | 説明 | |---|---| | list_issues | 課題を一覧表示 | | add_issue | 課題を1件追加 | | add_issues_bulk | 複数課題を一括追加 | | update_issue | 課題を1件更新 | | update_issues_bulk | 複数課題を一括更新 | | delete_issue | 課題を1件削除 | | delete_issues_bulk | 複数課題を一括削除 | | list_users | メンバー一覧を表示 |

CLI

コマンド一覧

# 接続確認
easy-backlog-tools

# 課題一覧
easy-backlog-tools list                          # アクティブのみ（未対応・処理中）
easy-backlog-tools list --all                    # 全件
easy-backlog-tools list --status 完了
easy-backlog-tools list --assignee 山田
easy-backlog-tools list --category バックエンド
easy-backlog-tools list --priority 高
easy-backlog-tools list --parent EASY-5          # 子課題のみ
easy-backlog-tools list --json                   # JSON出力

# メンバー一覧
easy-backlog-tools users
easy-backlog-tools users --json

# 課題追加（1件）
easy-backlog-tools add --title "タイトル" --priority 高 --category バックエンド --assignee 山田

# 課題追加（一括）
easy-backlog-tools add '[{"title":"タイトル1","priority":"高"},{"title":"タイトル2","category":"フロントエンド"}]'

# 課題更新（1件）
easy-backlog-tools update EASY-3 --status 完了

# 課題更新（一括）
easy-backlog-tools update '[{"key":"EASY-3","status":"完了"},{"key":"EASY-4","priority":"緊急"}]'

# 課題削除（1件）
easy-backlog-tools delete EASY-3

# 課題削除（一括）
easy-backlog-tools delete '["EASY-3","EASY-4"]'

# 一括操作（add + update + delete を1回で）
easy-backlog-tools exec '{"add":[{"title":"新機能"}],"update":[{"key":"EASY-3","status":"完了"}],"delete":["EASY-5"]}'

フィールド一覧

| フィールド | 説明 | 例 | |---|---|---| | title | タイトル | "ログイン画面の実装" | | status | 状態 | 未対応 / 処理中 / 完了 | | priority | 優先度 | 緊急 / 高 / 中 / 低 | | category | カテゴリ | フロントエンド / バックエンド など | | color | カラー（HEX） | "#0ea5e9" | | assignee | 担当者名（部分一致） | "山田" | | parent | 親課題キー | "EASY-5" | | description | 説明文 | "詳細テキスト" |

ライセンス

MIT