Noeto

noeto-mcp

AI エージェントが noeto のカンバンボードを操作できる MCP サーバーです。ボードの読み取り、カードの作成と更新、カードの移動やコメントの追加、カードに記載したドキュメントの管理ができます。

クイックスタート（Claude Code）

1. noeto で Settings → Access tokens → Create token を開き、シークレットをコピーします。

2. プラグインをインストールします。サーバーと /card ワークフローが含まれています。

   /plugin marketplace add noeto-tasks/noeto-mcp
   /plugin install noeto@noeto-mcp
   

3. トークンをエクスポートし、Claude Code を再起動します。

   export NOETO_TOKEN=noeto_pat_…
   export NOETO_API_URL=https://api.noeto.online/api/v1
   

次のように尋ねてみてください。「ボードには何がありますか？」 詳しくはプラグインの READMEをご覧ください。

その他の実行方法

任意の MCP ホストで使える Docker：

claude mcp add noeto -s user \
  -e NOETO_TOKEN=noeto_pat_… \
  -e NOETO_API_URL=https://api.noeto.online/api/v1 \
  -- docker run -i --rm -e NOETO_TOKEN -e NOETO_API_URL ghcr.io/noeto-tasks/noeto-mcp:v0.6.5

または、~/.claude.json、.mcp.json、Claude Desktop の設定に手動で追加します。

{
  "mcpServers": {
    "noeto": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "NOETO_TOKEN", "-e", "NOETO_API_URL",
               "ghcr.io/noeto-tasks/noeto-mcp:v0.6.5"],
      "env": {
        "NOETO_TOKEN": "noeto_pat_…",
        "NOETO_API_URL": "https://api.noeto.online/api/v1"
      }
    }
  }
}

Homebrew を使った ネイティブバイナリ：

brew install noeto-tasks/tap/noeto-mcp
claude mcp add noeto -s user \
  -e NOETO_TOKEN=noeto_pat_… \
  -e NOETO_API_URL=https://api.noeto.online/api/v1 \
  -- "$(brew --prefix)/bin/noeto-mcp"

または、リリースからアーカイブを取得します（macOS、Linux、Windows）。バイナリには署名がないため、macOS では最初に xattr -d com.apple.quarantine noeto-mcp を実行してください。設定では絶対パスを指定します。

知っておくと便利なこと

• 1 つのサーバーが提供するチームは 1 つです。チームはトークンによって決まります。2 つのチームを使う場合は、それぞれ専用のトークンを使って 2 つのエントリー（noeto-work、noeto-personal）を追加します。
• Docker でローカルの noeto に接続する場合は、http://host.docker.internal:8081/api/v1（macOS、Windows）または --network host（Linux）を使います。
• ローカルプロセスとして実行されるため、Claude Code と Claude Desktop では動作しますが、ブラウザー版の claude.ai やモバイルアプリでは動作しません。

ツール

ツール	機能
list_boards	カード数を含む、チームのボード一覧	読み取り
get_board	1 つのボードの列と、それぞれの列にあるカードを順番に取得	読み取り
find_cards	テキスト、担当者、ラベル、優先度、列、期日で全ボードを検索	読み取り
get_card	コメントと添付ファイルを含む、カードの全情報を取得	読み取り
list_members	チームのメンバーを取得	読み取り
whoami	トークンに紐づくメンバーを確認	読み取り
create_card	列にカードを追加	書き込み
update_card	タイトル、説明、担当者、優先度、期日、ラベルを更新	書き込み
move_card	別の列への移動、または同じ列内での並べ替え	書き込み
comment_on_card	コメントを投稿	書き込み
read_document	カードにあるドキュメントの Markdown を読み取り	読み取り
attach_document	ドキュメントを書き込み、同じ名前の既存ドキュメントを置き換え	置き換え
read_attachment	カードにあるテキストファイルまたは画像を読み取り	読み取り
download_attachment	カードにある任意のファイルをディスクに保存し、そのパスを返す	ローカルに保存

• ボード、列、ラベル、メンバーは名前で指定できます。例：move_card(card, column: "Done")。カード自体は ID で指定する必要があるため、名前を間違えて別のカードを編集することはありません。
• none を指定するとフィールドをクリアします。例：update_card(card, due: "none")。引数を省略すると変更されません。
• ドキュメントとテキストファイルの上限は 512 KB、画像の上限は 1.5 MB です。それより大きいファイルやその他の種類のファイルには download_attachment を使います。
• ダウンロード先は NOETO_DOWNLOAD_DIR です（デフォルトはシステムの一時ディレクトリ内の noeto-attachments）。Docker では、ホスト側とコンテナー側の両方で同じパスにディレクトリをマウントしてください。プラグインの設定ではすでにそうなっています。

ユーザーが作成したものを削除することは意図的にできず、ボード、列、ラベルも作成しません。これらを含む各種設計上の選択については、docs/internals.mdをご覧ください。

開発

make test         # hermetic, against a fake API
make smoke        # contract check against a running noeto (needs NOETO_TOKEN)
make lint
make docker       # build the image for this machine
make release-dry  # build release artifacts into dist/, publish nothing

API を変更した後は、make smoke を実行してください。

リリース： Actions → Release → バージョン（0.6.3）を指定してワークフローを実行します。 テストを実行し、バージョンを固定して、イメージをプッシュし、タグを付け、GitHub リリースと Homebrew cask を公開し、MCP Registry にバージョンを登録します。noeto-tasks/homebrew-tap への書き込み権限を持つ HOMEBREW_TAP_TOKEN シークレットが必要です。 make release-plugin RELEASE=x.y.z を実行すれば、レジストリ以外の同じ処理をローカルマシンから実行できます。その後、Publish to MCP Registry ワークフローを実行してください。