钉钉日程管理

使用 mcporter CLI 调用钉钉日历 MCP 创建和管理日程。

前置要求

安装 mcporter CLI

本技能依赖 mcporter 工具。请在终端中手动执行以下命令安装：

bash

使用 npm 安装

npm install -g mcporter

或使用 bun 安装

bun install -g mcporter

验证安装：
bash
mcporter --version

配置 MCP Server

本技能需要配置两个 MCP 服务：钉钉日历 和 钉钉通讯录。

步骤一：获取 Streamable HTTP URL

1. 1. 访问钉钉 MCP 广场：https://mcp.dingtalk.com
2. 搜索 钉钉日历，点击进入服务详情页
3. 在页面右侧找到 Streamable HTTP URL，点击复制按钮
4. 同样的方法，获取 钉钉通讯录 的 URL

步骤二：使用 mcporter 配置 MCP 服务

bash

添加钉钉日历 MCP 服务

mcporter config add dingtalk-calendar --url 这里粘贴钉钉日历的URL

添加钉钉通讯录 MCP 服务

mcporter config add dingtalk-contacts --url 这里粘贴钉钉通讯录的URL

步骤三：验证配置

bash

查看已配置的服务

mcporter config list

测试连接（列出可用工具）

mcporter call dingtalk-calendar list_tools --output json mcporter call dingtalk-contacts list_tools --output json

基本命令模式

所有操作通过 mcporter call dingtalk-calendar 执行：

bash

创建日程

mcporter call dingtalk-calendar createcalendarevent \
--args {summary:会议,startDateTime:2026-02-28T14:00:00+08:00,endDateTime:2026-02-28T15:00:00+08:00} \
--output json

查询日程

mcporter call dingtalk-calendar listcalendarevents \ --args {startTime:1738128000000,endTime:1738214400000} \ --output json

查询闲忙

mcporter call dingtalk-calendar querybusystatus \ --args {userIds:[userId1],startTime:1738128000000,endTime:1738214400000} \ --output json

核心工具

1. 创建日程

bash

基本创建

mcporter call dingtalk-calendar createcalendarevent \
--args {
summary: 项目评审会议,
startDateTime: 2026-02-28T14:00:00+08:00,
endDateTime: 2026-02-28T15:00:00+08:00,
description: 讨论 Q1 进度,
attendees: [userId1, userId2]
} \
--output json

参数说明：

参数	必填	说明
summary	✅	日程标题（最长 2048 字符）
startDateTime

✅ | 开始时间（ISO-8601 格式，如 2026-02-28T14:00:00+08:00） |
| endDateTime | ✅ | 结束时间（ISO-8601 格式） |
| description | ❌ | 日程描述（最长 5000 字符） |
| attendees | ❌ | 参与人 userId 列表（最多 500 人） |

2. 查询日程列表

bash

查询指定时间范围的日程

mcporter call dingtalk-calendar listcalendarevents \
--args {
startTime: 1738128000000,
endTime: 1738214400000
} \
--output json

3. 查询他人闲忙

bash
mcporter call dingtalk-calendar querybusystatus \
--args {
userIds: [userId1, userId2],
startTime: 1738128000000,
endTime: 1738214400000
} \
--output json

4. 查询空闲会议室

bash
mcporter call dingtalk-calendar queryavailablemeeting_room \
--args {
startTime: 1738128000000,
endTime: 1738131600000
} \
--output json

5. 为日程添加会议室

bash
mcporter call dingtalk-calendar addmeetingroom \
--args {
eventId: 日程ID,
roomIds: [会议室ID1]
} \
--output json

6. 更新日程

bash
mcporter call dingtalk-calendar updatecalendarevent \
--args {
eventId: 日程ID,
summary: 新标题,
description: 新描述
} \
--output json

7. 删除日程

bash
mcporter call dingtalk-calendar deletecalendarevent \
--args {eventId: 日程ID} \
--output json

通讯录工具

搜索用户

bash
mcporter call dingtalk-contacts searchuserbykeyword \
--args {keyWord: 张三} \
--output json

获取用户详情

bash
mcporter call dingtalk-contacts getuserinfobyuser_ids \
--args {useridlist: [userId1, userId2]} \
--output json

常用时间格式

python
import time
from datetime import datetime

获取当前时间戳（毫秒）

int(time.time() * 1000)

时间戳转 ISO 8601

datetime.fromtimestamp(1738128000000 / 1000).strftime(%Y-%m-%dT%H:%M:%S+08:00)

ISO 8601 转时间戳（毫秒）

int(datetime.fromisoxt(2026-02-28T14:00:00+08:00).timestamp() * 1000)

使用示例

创建会议并预订会议室

bash

1. 查询14:00-15:00的空闲会议室

mcporter call dingtalk-calendar queryavailablemeeting_room \
--args {startTime:1738128000000,endTime:1738131600000} \
--output json

2. 创建日程（假设获取到会议室ID: room123）

mcporter call dingtalk-calendar createcalendarevent \ --args { summary: 周会, startDateTime: 2026-02-28T14:00:00+08:00, endDateTime: 2026-02-28T15:00:00+08:00 } \ --output json

3. 添加会议室（假设日程ID: event123）

mcporter call dingtalk-calendar addmeetingroom \ --args {eventId:event123,roomIds:[room123]} \ --output json