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

快速开始

使用Rube

1. 访问Rube.app
2. 在你偏好的客户端中安装Rube，包括Cursor、Claude、VS Code、Windsurf等。
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/目录中创建源和轮子分布。

3. 发布到PyPI：

uv publish

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

• Token: --token 或 UV_PUBLISH_TOKEN
• 或用户名/密码: --username/UV_PUBLISH_USERNAME 和 --password/UV_PUBLISH_PASSWORD

调试

由于MCP服务器通过标准I/O运行，调试可能会很困难。为了获得最佳的调试体验，我们强烈建议使用MCP Inspector。

你可以通过npm使用以下命令启动MCP Inspector：

npx @modelcontextprotocol/inspector uv run mcp-server-monday

启动后，Inspector会显示一个可以在浏览器中访问的URL以开始调试。