MCP Meet

🚀 mcp-meet

mcp-meet 是一款實用工具，它能讓你告別谷歌應用在本地運行時的高能耗問題，藉助它，你可以讓 Claude 幫你在蘋果日曆中安排日程，並自動生成谷歌會議鏈接，極大提升日程安排效率。

🚀 快速開始

如果你和我一樣，討厭在本地運行谷歌應用，因為它們會大量消耗電池電量，而更傾向於使用蘋果原生應用，那麼你肯定知道，用谷歌會議安排日曆事件是一件非常煩人的事情。有了 mcp-meet，你只需讓 Claude 為你安排活動，它就會在你的蘋果日曆中進行安排，並生成一個谷歌會議鏈接。

✨ 主要特性

• 聯繫人搜索：可通過姓名或電子郵件在谷歌聯繫人中查找人員。
• 智能可用性檢查：能跨多個日曆和參會者檢查空閒/忙碌狀態。
• 共同空閒時段查找：找出所有人實際都有空的時間。
• 一鍵安排：自動找到最佳時段並預訂。
• 谷歌會議鏈接生成：每場會議都會附帶一個隨時可用的谷歌會議鏈接。
• 蘋果日曆同步：會議會自動顯示在 macOS 日曆應用中。
• 完整的 CRUD 操作：支持列出、查看、更新和刪除會議，並與谷歌和蘋果日曆同步。

📚 詳細文檔

工作原理

賬戶工具

1. list_accounts：列出所有已配置的谷歌賬戶及其標籤。

日程安排工具

2. search_invitees：在谷歌聯繫人中搜索電子郵件地址。
3. find_slots：獲取所有參會者的共同空閒時段列表。
4. create_meet_and_calendar：創建帶有谷歌會議鏈接的谷歌日曆活動，並同步到蘋果日曆。
5. plan_and_schedule：智能功能，能找到符合你指定時長的第一個可用時段並立即預訂。

會議管理工具

6. list_meetings：列出指定時間窗口內所有即將舉行的谷歌會議。
7. get_meeting_details：通過會議 ID 獲取特定會議的詳細信息。
8. update_meeting：更新會議標題、時間、描述或參會者信息（同步到蘋果日曆）。
9. 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 設置

1. 訪問 谷歌雲控制檯。
2. 創建一個新項目（或選擇現有項目）。
3. 啟用 谷歌日曆 API 和 人員 API。
4. 創建 OAuth 2.0 憑證（桌面應用類型）。
5. 添加 http://localhost:5173 作為授權重定向 URI。
6. 將你的客戶端 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 許可證。

👥 貢獻說明

歡迎提出問題和提交拉取請求！