monday.com MCP Server について
monday.com API MCP Server は、MCP クライアントから monday.com API にアクセスするための MCP サーバーです。npx パッケージとして実行され、AI アシスタントから monday.com アカウントを操作したいユーザーを対象としています。
主な機能
- 01API トークンによる monday.com への接続
- 02データ取得用のリードオンリーモード
- 03API、Apps、ATP から選べるツールモード
- 04引数または環境変数によるトークン指定
- 05ベータ版の動的 API ツール
活用シーン
- 01Claude Desktop から monday.com のボードデータを照会
- 02Cursor からプロジェクトのアイテムを管理
- 03リードオンリーモードでボード情報を取得
MCP 対応
本プロジェクトは MCP サーバーであり、monday.com API の操作を MCP クライアントへツールとして公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
monday.com API MCP サーバー
monday.com API とやり取りするためのインターフェースを提供する、Model Context Protocol (MCP) のサーバー実装です。
💻 Claude Desktop のデモ
https://github.com/user-attachments/assets/ed8d24e1-256b-4f6b-9d84-38e54a8703fd
前提条件
MCP サーバーを実行する前に、以下を用意してください。
- Node v20 以上がインストールされていること
- NPM v5.2.0 以上がインストールされていること
- monday.com API キー
⚙️ 使用方法
npx @mondaydotcomorg/monday-api-mcp@latest -t abcd123
monday.com API トークンは、monday_token 環境変数で指定することもできます。
コマンドライン引数
| 引数 | フラグ | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| monday.com API トークン | --token, -t | monday.com API トークン(monday_token 環境変数で指定することもできます) | はい | - |
| API バージョン | --version, -v | monday.com API バージョン | いいえ | current |
| 読み取り専用モード | --read-only, -ro | 読み取り専用モードを有効にします | いいえ | false |
| モード | --mode, -m | ツール選択のモードを設定します。「api」- API ツールのみ、「apps」-(ベータ版)Monday Apps ツールのみ、「atp」-(アルファ版)ATP サーバーモード | いいえ | api |
| 動的 API ツール | --enable-dynamic-api-tools, -edat | (ベータ版)動的 API ツールを有効にします(API スキーマ全体を含むモードです。読み取り専用モードでは使用できません) | いいえ | false |
🧪 ATP モード(アルファ版)
ATP(Agent Tool Protocol)モードは、GraphQL API の探索とコード実行機能を利用できる代替の統合方法を提供します。このモードでは、次の 2 つの強力なツールを使用できます。
- explore_api:monday.com GraphQL API の構造をたどり、検出します
- execute_code:JavaScript コードを実行し、monday.com API を動的に呼び出します
⚠️ アルファ版の機能:ATP モードは現在アルファ版です。API や動作は変更される可能性があります。
使用方法
npx @mondaydotcomorg/monday-api-mcp@latest -t abcd123 -m atp
Cursor との統合(ATP モード)
{
"mcpServers": {
"monday-api-mcp": {
"command": "npx",
"args": [
"@mondaydotcomorg/monday-api-mcp@latest",
"-t",
"abcd123",
"-m",
"atp"
],
"env": {
"NODE_OPTIONS": "--no-node-snapshot"
}
}
}
}
💻 Claude Desktop との統合
{
"mcpServers": {
"monday-api-mcp": {
"command": "npx",
"args": [
"@mondaydotcomorg/monday-api-mcp@latest",
"-t",
"abcd123"
]
}
}
}
💻 Cursor との統合
コマンドライン引数を使用する場合
{
"mcpServers": {
"monday-api-mcp": {
"command": "npx",
"args": [
"@mondaydotcomorg/monday-api-mcp@latest",
"-t",
"abcd123"
],
"env": {}
}
}
}
環境変数を使用する場合
{
"mcpServers": {
"monday-api-mcp": {
"command": "npx",
"args": [
"@mondaydotcomorg/monday-api-mcp@latest"
],
"env": {
"monday_token": "abcd123"
}
}
}
}
ライセンス
このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルをご覧ください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。