Monday.com MCP server

Monday.com MCP サーバー

MCP クライアントが Monday.com のボード、アイテム、更新、ドキュメントを操作できる MCP サーバーです。

コンポーネント

ツール

このサーバーでは、以下のツールを実装しています。

• monday-create-item：Monday.com のボードに新しいアイテムまたはサブアイテムを作成します
• monday-get-board-groups：指定した Monday.com のボードからすべてのグループを取得します
• monday-create-update：Monday.com のアイテムにコメント／更新を作成します
• monday-list-boards：利用可能な Monday.com のボードをすべて一覧表示します
• monday-list-items-in-groups：Monday.com のボードの指定したグループ内にあるすべてのアイテムを一覧表示します
• monday-list-subitems-in-items：指定した Monday.com のアイテムに属するすべてのサブアイテムを一覧表示します
• monday-create-board：新しい Monday.com のボードを作成します
• monday-create-board-group：Monday.com のボードに新しいグループを作成します
• monday-move-item-to-group：Monday.com のアイテムを別のグループに移動します
• monday-delete-item：Monday.com のアイテムを削除します
• monday-archive-item：Monday.com のアイテムをアーカイブします
• monday-get-item-updates：特定のアイテムの更新／コメントを取得します
• monday-get-docs：Monday.com のドキュメントを一覧表示します。必要に応じてフォルダーで絞り込めます
• monday-get-doc-content：特定のドキュメントの内容を取得します
• monday-create-doc：Monday.com に新しいドキュメントを作成します
• monday-add-doc-block：既存のドキュメントにブロックを追加します

セットアップ

1. こちらの手順に従い、Monday.com で個人用 API トークンを作成して保存します。
2. Monday.com ワークスペースの URL からワークスペース名を取得します。たとえば、URL が https://myworkspace.monday.com/ の場合、ワークスペース名は myworkspace です。

クイックスタート

インストール

Claude Desktop

MacOS の場合：~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows の場合：%APPDATA%/Claude/claude_desktop_config.json

uvx を使用する場合

"mcpServers": {
  "monday": {
    "command": "uvx",
    "args": [
      "mcp-server-monday"
    ],
    "env": {
      "MONDAY_API_KEY": "your-monday-api-key",
      "MONDAY_WORKSPACE_NAME": "your-monday-workspace-name"
    }
  }
}

Docker を使用する場合

"mcpServers": {
  "monday-docker": {
    "command": "docker",
    "args": [
      "run", 
      "--rm", 
      "-i", 
      "-e",
      "MONDAY_API_KEY=your-monday-api-key",
      "-e",
      "MONDAY_WORKSPACE_NAME=your-monday-workspace-name",
      "sakce/mcp-server-monday"
    ]
  }
}

Smithery を使用する場合

Smithery を使って、Claude Desktop 用の Monday.com MCP Server を自動でインストールするには：

npx -y @smithery/cli install @sakce/mcp-server-monday --client claude

開発

ビルドと公開

配布用のパッケージを準備するには：

1. 依存関係を同期し、ロックファイルを更新します：

uv sync

2. パッケージの配布物をビルドします：

uv build

これにより、ソース配布物とホイール配布物が dist/ ディレクトリに作成されます。

3. PyPI に公開します：

uv publish

注：PyPI の認証情報は、環境変数またはコマンドフラグで設定する必要があります：

• トークン：--token または UV_PUBLISH_TOKEN
• またはユーザー名／パスワード：--username／UV_PUBLISH_USERNAME および --password／UV_PUBLISH_PASSWORD

デバッグ

MCP サーバーは stdio 経由で実行されるため、デバッグは難しいことがあります。最適なデバッグ体験のために、MCP Inspector の使用を強くおすすめします。

次のコマンドを使い、npm 経由で MCP Inspector を起動できます：

npx @modelcontextprotocol/inspector uv run mcp-server-monday

起動すると、Inspector に URL が表示されます。その URL にブラウザーからアクセスして、デバッグを開始できます。