MCP Server Monday Qi

🚀 Monday.com MCP サーバー

monday.com 用の MCP サーバーです。これにより、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-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. こちら の説明に従って、個人用の 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 サーバーを自動インストールします：

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

🔧 技術詳細

ビルドと公開

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

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

uv sync

2. パッケージのリリース版をビルドします：

uv build

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

3. PyPI に公開します：

uv publish

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

• トークン：--token
• ユーザー名：--username

デバッグ

Inspector を使用してデバッグします：

uv run mcp-server-monday -- inspector

コンソールを開いて出力を確認し、表示された URL をコピーしてブラウザに貼り付けてデバッグを行います。