Monday.com MCP Server

Name: Monday.com MCP Server
Author: Nasseratic

本地服务

github.com/Nasseratic生产力073 周前更新

代码仓库

关于 Monday.com MCP Server

Monday.com MCP Server 是用于管理指定 Monday.com 看板任务数据的 TypeScript 服务。MCP 客户端可查询分配给当前用户的项目及看板详情、创建任务，并更新状态或列值。

主要功能

01列出分配给当前用户的项目
02创建看板任务
03灵活匹配并更新任务状态
04编辑自定义任务列值
05获取分组和项目详情

适用场景

01查看看板上分配的任务
02向 Monday.com 看板添加任务
03更改任务状态
04检查项目的列和值

MCP 相关

它将 Monday.com 任务操作作为工具提供给 MCP 客户端。

#mcp-server #monday-com #task-management

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "monday-nasseratic": {
      "command": "npx",
      "args": [
        "-y",
        "@nasseratic/monday-mcp-server"
      ],
      "env": {
        "MONDAY_API_KEY": "<MONDAY_API_KEY>",
        "MONDAY_TASKS_BOARD_ID": "<MONDAY_TASKS_BOARD_ID>"
      }
    }
  }
}

启动命令npx -y @nasseratic/monday-mcp-server

需要配置的环境变量

MONDAY_API_KEY密钥

MONDAY_TASKS_BOARD_ID

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@nasseratic/monday-mcp-serverstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Monday.com MCP 服务

这是一个以 TypeScript 实现的 Monday.com 模型上下文协议（MCP）服务，用于处理与 Monday.com 任务相关的操作。

可用工具

此 MCP 服务提供以下工具，用于与 Monday.com 交互：

my-items：获取当前用户在已配置看板中负责的条目
add-task：向 Monday.com 看板添加新任务（条目）
update-task-status：更新任务（条目）的状态，并智能匹配状态
update-task：使用自定义列值更新任务（条目）（高级）
get-groups：获取 Monday.com 看板中的所有分组
get-item-details：获取特定条目的详细信息，包括其所有列和值

状态更新示例

update-task-status 工具支持智能状态匹配。你可以使用自然语言，例如：

“in progress”——匹配 “In Progress”、“Working”、“WIP” 等
“done”——匹配 “Done”、“Complete”、“Completed”、“Finished” 等
“in review”——匹配 “In Review”、“Review”、“Pending Review” 等
“stuck”——匹配 “Stuck”、“Blocked”、“Blocker” 等

开始使用

选项 1：直接使用（推荐）

无需克隆，直接通过 pnpm dlx 使用此软件包：

配置 MCP 服务

在 ~/.cursor/mcp.json 文件中配置环境变量：

{
  "mcpServers": {
    "monday": {
      "command": "pnpm",
      "args": ["dlx", "@nasseratic/monday-mcp-server@latest"],
      "env": {
       "MONDAY_API_KEY": "your_monday_api_key",
       "MONDAY_TASKS_BOARD_ID": "your_monday_board_id"
     }
   }
 }

}


 - `MONDAY_API_KEY`：你的 Monday.com API 令牌。
 - `MONDAY_TASKS_BOARD_ID`：包含任务的 Monday.com 看板 ID

### 选项 2：开发环境设置

如果你想修改源代码或参与贡献：

1. **克隆仓库**

 ```bash
 git clone https://github.com/Nasseratic/mcp-server-monday.git
 cd mcp-server-monday

安装依赖项
```
pnpm install
```

开发配置

在 ~/.cursor/mcp.json 文件中配置环境变量，以使用本地开发版本：

{
  "mcpServers": {
    "monday": {
      "command": "pnpm",
      "args": ["start"],
      "cwd": "/path/to/your/mcp-server-monday",
      "env": {
       "MONDAY_API_KEY": "your_monday_api_key",
       "MONDAY_TASKS_BOARD_ID": "your_monday_board_id"
     }
   }
 }

}


 - 将 `/path/to/your/mcp-server-monday` 替换为你克隆仓库的实际路径。

## Monday.com API 设置

获取 Monday.com API 令牌：

1. 前往你的 Monday.com 账户
2. 点击头像 > Developers > My API tokens
3. 生成具有适当权限的新 API 令牌

获取 Monday.com 看板 ID：

1. 在 Monday.com 中打开看板
2. 看板 ID 是 URL 中 “boards/” 后面的数字

支持 Markdown

登录后评论