飞书日历 MCP 服务器
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@飞书日历 MCP 服务器 查询我明天的空闲时间,需要安排1小时的会议"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
飞书日历 MCP 服务器
Feishu Calendar MCP Server - 用于将飞书日历 API 包装成 Model Context Protocol (MCP) 服务器。
功能特性
日历管理: 获取、创建、更新、删除日历
日程管理: 获取、创建、更新、删除日程事件
订阅管理: 订阅/取消订阅日历
忙碌状态: 查询用户忙碌状态和可用时间
简单认证: 支持多种认证方式,推荐使用 app_access_token(最简单)
Related MCP server: calendar-mcp
快速开始
1. 安装依赖
npm install
npm run build2. 获取飞书应用凭证
访问 飞书开放平台
创建自建应用
获取 App ID 和 App Secret
3. 配置应用权限
在飞书开放平台配置应用:
进入你的应用管理页面
权限管理 → 权限配置,开通以下权限:
calendar:calendar- 查看、管理日历calendar:event- 查看、创建、编辑日程
4. 配置认证方式
本服务器支持三种认证方式,推荐使用方式一(最简单):
方式一:App Access Token(推荐,最简单)
只需配置 app_id 和 app_secret,系统自动获取 app_access_token。
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxx
FEISHU_USE_APP_TOKEN=true无需任何额外配置,这是最简单的方式!
方式二:Refresh Token(自动刷新)
通过 OAuth 授权获取 refresh_token,系统会自动刷新 access_token。
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxx
FEISHU_REFRESH_TOKEN=你的刷新令牌运行授权脚本获取 refresh_token:
npm run auth按照提示在浏览器中完成授权,refresh_token 会自动保存到 .env 文件。
方式三:User Access Token(手动管理)
直接使用 user_access_token,但需要注意 token 有效期约 2 小时,过期需要重新获取。
FEISHU_APP_ID=cli_xxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxx
FEISHU_USER_ACCESS_TOKEN=你的用户访问令牌5. 在 Claude Desktop 中使用
编辑 Claude Desktop 配置文件:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
配置方式选择
根据你的安装方式选择对应的配置:
方式一:全局安装(推荐,最简单)
先全局安装:
npm install -g feishu-calendar-mcp配置:
{
"mcpServers": {
"feishu-calendar": {
"command": "feishu-calendar-mcp",
"args": [],
"env": {
"FEISHU_APP_ID": "your_app_id",
"FEISHU_APP_SECRET": "your_app_secret",
"FEISHU_USE_APP_TOKEN": "true"
}
}
}
}方式二:使用 npx(无需安装)
配置:
{
"mcpServers": {
"feishu-calendar": {
"command": "npx",
"args": ["-y", "feishu-calendar-mcp"],
"env": {
"FEISHU_APP_ID": "your_app_id",
"FEISHU_APP_SECRET": "your_app_secret",
"FEISHU_USE_APP_TOKEN": "true"
}
}
}
}方式三:本地开发路径
如果你在开发目录下使用:
{
"mcpServers": {
"feishu-calendar": {
"command": "node",
"args": ["/absolute/path/to/feishu-calendar/dist/index.js"],
"env": {
"FEISHU_APP_ID": "your_app_id",
"FEISHU_APP_SECRET": "your_app_secret",
"FEISHU_USE_APP_TOKEN": "true"
}
}
}
}认证方式选择
使用 App Access Token(推荐):
"env": {
"FEISHU_APP_ID": "your_app_id",
"FEISHU_APP_SECRET": "your_app_secret",
"FEISHU_USE_APP_TOKEN": "true"
}使用 Refresh Token:
"env": {
"FEISHU_APP_ID": "your_app_id",
"FEISHU_APP_SECRET": "your_app_secret",
"FEISHU_REFRESH_TOKEN": "your_refresh_token"
}配置完成后,重启 Claude Desktop 即可使用。
6. 测试连接
npm run build
npx tsx test-client.ts可用工具
日历相关
工具名 | 描述 | 必需参数 |
| 获取日历列表 | - |
| 获取日历详情 | calendar_id |
| 创建日历 | summary |
| 更新日历 | calendar_id |
| 删除日历 | calendar_id |
日程事件相关
工具名 | 描述 | 必需参数 |
| 获取日程列表 | calendar_id |
| 获取日程详情 | calendar_id, event_id |
| 创建日程 | calendar_id, summary, start_time, end_time |
| 更新日程 | calendar_id, event_id |
| 删除日程 | calendar_id, event_id |
订阅相关
工具名 | 描述 | 必需参数 |
| 订阅日历 | calendar_id |
| 取消订阅日历 | calendar_id |
忙碌状态相关
工具名 | 描述 | 必需参数 |
| 查询忙碌状态 | calendar_ids, start_time, end_time |
| 获取可用时间 | calendar_id, start_time, end_time, duration_minutes |
使用示例
在 Claude Desktop 中使用
查询我的日历列表:
请帮我查询所有日历创建一个日程:
帮我创建一个明天下午2点的会议,主题是"产品讨论会",时长1小时查询某段时间的空闲时间:
查询明天上午9点到12点之间,我有哪段空闲时间可以安排30分钟的会议API 直接调用示例
创建日程(完整参数)
curl -i -X POST \
'https://open.feishu.cn/open-apis/calendar/v4/calendars/{calendar_id}/events?user_id_type=open_id' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {your_user_access_token}' \
-d '{
"summary": "团队周会",
"description": "每周项目进度同步会议",
"start_time": {
"timestamp": "1738360800",
"timezone": "Asia/Shanghai"
},
"end_time": {
"timestamp": "1738364400",
"timezone": "Asia/Shanghai"
},
"visibility": "default",
"attendee_ability": "can_see_others",
"free_busy_status": "busy",
"location": "会议室 A"
}'参数说明
时间参数
参数 | 类型 | 说明 | 示例 |
| string | Unix 时间戳(秒) |
|
| string | 时区 |
|
注意: 飞书 API 使用秒级时间戳,不是毫秒!
可见性 (visibility)
值 | 说明 |
| 默认 |
| 公开 |
| 私密 |
参与者能力 (attendee_ability)
值 | 说明 |
| 可见其他参与者 |
| 不可见其他参与者 |
忙碌状态 (free_busy_status)
值 | 说明 |
| 忙碌 |
| 空闲 |
开发
# 安装依赖
npm install
# 开发模式运行
npm run dev
# 构建
npm run build注意事项
认证方式: 推荐使用 app_access_token(只需 app_id 和 app_secret,最简单)
Token 刷新: refresh_token 会自动刷新 access_token,无需手动干预
时间格式: API 使用 Unix 时间戳(秒)
权限配置: 确保应用已获取足够的权限
API 限制: 飞书 API 有调用频率限制,请注意控制调用频率
许可证
MIT
Available Tools
14 toolsfeishu_create_calendarA
创建新的飞书日历。当用户说"创建日历"、"新建日历"时使用。
Inputs: summary (required), color, description.
feishu_create_eventB
创建飞书日程/会议。当用户说"创建日程"、"新建会议"、"安排会议"、"添加日程"、"预约"等类似话语时使用。需要提供日历ID、标题、开始时间和结束时间。
Inputs: summary (required), end_time (required), start_time (required), calendar_id (required), +7 more.
feishu_delete_calendarC
删除飞书日历
Inputs: calendar_id (required).
feishu_delete_eventC
删除日程 (Delete event)
Inputs: event_id (required), calendar_id (required).
feishu_get_available_timeC
获取可用时间段 (Get available time slots)
Inputs: end_time (required), start_time (required), calendar_id (required), duration_minutes (required).
feishu_get_calendarB
获取指定飞书日历的详细信息,需要提供日历 ID
Inputs: calendar_id (required).
feishu_get_calendar_listA
查询所有飞书日历。当用户说"查询日历"、"查看日历"、"我的日历"、"有哪些日历"等类似话语时使用。
Inputs: page_size, page_token.
feishu_get_eventC
获取飞书日程详情
Inputs: event_id (required), calendar_id (required).
feishu_get_event_listB
查询飞书日程/事件列表。当用户说"查看日程"、"今天的安排"、"查询日程"、"有哪些会议"等类似话语时使用。需要提供日历 ID。
Inputs: calendar_id (required), end_time, page_size, page_token, +1 more.
feishu_get_free_busyD
查询用户忙碌状态 (Get user free/busy status)
Inputs: end_time (required), start_time (required), calendar_ids (required).
feishu_subscribe_calendarC
订阅日历 (Subscribe to calendar)
Inputs: calendar_id (required).
feishu_unsubscribe_calendarC
取消订阅日历 (Unsubscribe from calendar)
Inputs: calendar_id (required).
feishu_update_calendarC
更新飞书日历信息
Inputs: calendar_id (required), color, summary, description.
feishu_update_eventD
更新飞书日程
Inputs: event_id (required), calendar_id (required), summary, end_time, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools are clearly distinct (e.g., calendar vs event operations). However, feishu_get_available_time and feishu_get_free_busy may overlap in purpose, as both deal with user availability, though free_busy typically shows busy times while available_time suggests open slots. This mild overlap prevents a perfect score.
All tools follow a consistent pattern: 'feishu_' prefix followed by verb_noun (e.g., get_calendar_list, create_event). Naming is uniform and predictable throughout.
With 14 tools, the count is reasonable for a calendar service covering calendars and events, but slightly on the higher end. Each tool appears to have a distinct function, though some could potentially be merged.
The tool set provides comprehensive CRUD coverage for both calendars and events, plus subscription management and availability queries. This covers the core domain thoroughly with no obvious gaps.
Maintenance
Related MCP Connectors
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
A MCP server that works with Google Calendar to manage event listing, reading, and updates.
Hosted MCP server with managed OAuth for 15+ toolkits: Google Workspace, Fitbit, Oura, Kalshi, etc.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA read-only MCP server that exposes iCalendar feeds as queryable tools for LLM agents, enabling calendar event retrieval and filtering.MIT
- AlicenseNot gradedqualityDmaintenanceProvider-agnostic CalDAV calendar MCP server that connects any CalDAV calendar to AI assistants, enabling calendar operations like listing, creating, updating, and deleting events.AGPL 3.0
- AlicenseAqualityBmaintenanceMCP server for Apple Calendar and CalDAV providers. Enables listing, creating, updating, deleting events, and checking free/busy status with per-calendar write protection.6MIT
- AlicenseNot gradedqualityDmaintenanceMCP server that enables AI agents to interact with Feishu (Lark) for calendar events, attendees, and user recent work via structured tools with graceful degradation and recovery hints.MIT