Monday.com MCP server

Monday.com MCP サーバー

MCP Server for monday.com は、MCP クライアントが Monday.com のボード、アイテム、更新、ドキュメントを操作できるようにします。

コンポーネント

ツール

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

• 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 Token を作成して保存します。
2. Monday.com のワークスペースの URL からワークスペース名を取得します。たとえば、URL が https://myworkspace.monday.com/ の場合、ワークスペース名は myworkspace です。

クイックスタート

Rube を使用する

1. (Rube.app)[https://rube.app/] にアクセスします
2. Cursor、Claude、VS Code、Windsurf など、お好みのクライアントに Rube をインストールします
3. Rube で認証を完了します
4. アイテムの作成、更新の投稿、アイテムの移動など、Monday.com で操作を実行できるようになります

インストール

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

開発

ビルドと公開

パッケージを配布用に準備するには、以下を実行します。

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

uv sync

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

uv build

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

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 にブラウザーからアクセスして、デバッグを開始できます。