Monday.com MCP server

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.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。

快速入门

安装

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/ 目录中创建源代码分发包和 wheel 分发包。

3. 发布到 PyPI：

uv publish

注意：你需要通过环境变量或命令标志设置 PyPI 凭据：

• Token：--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 开始调试。