JinDaGe - mcp-meet MCP Details

article

README

🚀 mcp-meet

mcp-meet 是一款实用工具，它能让你告别谷歌应用在本地运行时的高能耗问题，借助它，你可以让 Claude 帮你在苹果日历中安排日程，并自动生成谷歌会议链接，极大提升日程安排效率。

🚀 快速开始

如果你和我一样，讨厌在本地运行谷歌应用，因为它们会大量消耗电池电量，而更倾向于使用苹果原生应用，那么你肯定知道，用谷歌会议安排日历事件是一件非常烦人的事情。有了 mcp-meet，你只需让 Claude 为你安排活动，它就会在你的苹果日历中进行安排，并生成一个谷歌会议链接。

✨ 主要特性

联系人搜索：可通过姓名或电子邮件在谷歌联系人中查找人员。
智能可用性检查：能跨多个日历和参会者检查空闲/忙碌状态。
共同空闲时段查找：找出所有人实际都有空的时间。
一键安排：自动找到最佳时段并预订。
谷歌会议链接生成：每场会议都会附带一个随时可用的谷歌会议链接。
苹果日历同步：会议会自动显示在 macOS 日历应用中。
完整的 CRUD 操作：支持列出、查看、更新和删除会议，并与谷歌和苹果日历同步。

📚 详细文档

工作原理

账户工具

list_accounts：列出所有已配置的谷歌账户及其标签。

日程安排工具

search_invitees：在谷歌联系人中搜索电子邮件地址。
find_slots：获取所有参会者的共同空闲时段列表。
create_meet_and_calendar：创建带有谷歌会议链接的谷歌日历活动，并同步到苹果日历。
plan_and_schedule：智能功能，能找到符合你指定时长的第一个可用时段并立即预订。

会议管理工具

list_meetings：列出指定时间窗口内所有即将举行的谷歌会议。
get_meeting_details：通过会议 ID 获取特定会议的详细信息。
update_meeting：更新会议标题、时间、描述或参会者信息（同步到苹果日历）。
delete_meeting：从谷歌和苹果日历中删除会议。

安装指南

前提条件

Node.js 18 或更高版本。
启用了日历和人员 API 的谷歌云项目。
OAuth 2.0 凭证（客户端 ID 和密钥）。
macOS 系统（用于苹果日历集成）。

安装步骤

npm install mcp-meet

或者从源代码克隆并构建：

git clone https://github.com/znz-systems/mcp-meet.git
cd mcp-meet
pnpm install
pnpm build

配置

创建一个 .env 文件，并填入你的谷歌 OAuth 凭证：

GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_REDIRECT_URI=http://localhost:5173

# 可选：指定用于检查可用性的日历（用逗号分隔）
CALENDAR_IDS=primary,your-other-calendar@gmail.com

# 可选：指定用于创建活动的苹果日历名称（默认为 "Meetings"）
APPLE_CALENDAR_NAME=Work

谷歌 OAuth 设置

访问谷歌云控制台。
创建一个新项目（或选择现有项目）。
启用 谷歌日历 API 和 人员 API。
创建 OAuth 2.0 凭证（桌面应用类型）。
添加 http://localhost:5173 作为授权重定向 URI。
将你的客户端 ID 和客户端密钥复制到 .env 文件中。

首次认证

运行认证流程以授予访问权限：

pnpm cli auth

这将打开你的浏览器进行谷歌登录。完成后，令牌将保存到 ~/.config/mcp-meet/tokens.json，你就可以开始使用了。

使用示例

作为 MCP 服务器

使用标准输入输出传输启动服务器（用于 AI 助手集成）：

node dist/index.js

或者在开发环境中：

pnpm dev

你的 MCP 客户端（如 Claude Desktop）随后可以调用可用的工具。

Claude Desktop / Claude Code 配置

添加到你的 MCP 设置（claude_desktop_config.json 或 .mcp.json）：

{
  "mcpServers": {
    "mcp-meet": {
      "command": "npx",
      "args": ["-y", "mcp-meet"]
    }
  }
}

或者如果你是全局安装的：

{
  "mcpServers": {
    "mcp-meet": {
      "command": "mcp-meet"
    }
  }
}

📄 许可证

本项目采用 MIT 许可证。

👥 贡献说明

欢迎提出问题和提交拉取请求！

mcp-meet