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 令牌：链接。
2. 从您的 Monday.com 工作区 URL 获取工作区名称。例如，如果 URL 是 https://myworkspace.monday.com/，则工作区名称为 myworkspace。

快速入门

安装

Claude 桌面版

对于 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 桌面版的 Monday.com MCP 服务器：

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

开发

构建和发布

准备分发包：

1. 同步依赖项并更新锁文件：

uv sync

1. 构建包分发：

uv build

这将在 dist/ 目录中创建源码和 wheel 分发。

1. 发布到 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以开始调试。