谷歌日历MCP服务器
您的个人AI助手，用于谷歌日历和谷歌文档。
谷歌日历MCP是一个开源服务器，可以将自然语言转化为结构化的日程和笔记。它由现代LLM和模型控制协议（MCP）提供支持，可以帮助您自动计划、记忆和反思。
______________________________________________________________________
特性
- 自然语言议程解析\
“下周四下午2点与Sam见面喝咖啡”→ 谷歌日历事件+提醒
- 谷歌文档日志\
“每周日写一篇每周反思”→ 自动生成的文档+带时间戳的条目
- 提醒工作\
自动设置提醒：活动前1天1小时（或自定义）
- 模型灵活（GPT、Claude、Gemini）\
带上自己的LLM，并通过适配器将其插入
- 隐私第一\
自托管，可完全控制您的数据和API
______________________________________________________________________
架构文档
此存储库包含Google Calendar MCP服务器的全面架构文档：
系统架构
谷歌日历MCP遵循模块化架构，组件之间有明确的界限：
graph TB
subgraph "Client Layer"
CLI[Command Line Interface]
API[RESTful API]
WH[Webhooks]
end
subgraph "Core Layer"
Router[MCP Router]
Auth[Authentication Module]
NLP[Natural Language Parser]
Memory[Memory Module]
Queue[Task Queue]
end
subgraph "Integration Layer"
Calendar[Google Calendar Integration]
Docs[Google Docs Integration]
end
subgraph "Model Layer"
ModelRouter[AI Model Router]
GPT[GPT-4o Adapter]
Claude[Claude Adapter]
Gemini[Gemini Adapter]
end
subgraph "Infrastructure Layer"
DB[(Database)]
Cache[(Cache)]
Scheduler[Cron Scheduler]
end
%% Core connections
CLI --> Router
API --> Router
WH --> Router
Router --> Auth
Router --> NLP
Router --> Calendar
Router --> Docs
Router --> Memory
Router --> Queue
NLP --> ModelRouter
ModelRouter --> GPT
ModelRouter --> Claude
ModelRouter --> Gemini快速开始
先决条件
- Node.js（v18或更高版本）
- npm或纱线
- MongoDB（本地开发可选）
- Redis（本地开发可选）
安装
- 克隆存储库：
git clone https://github.com/yourusername/google-calendar-mcp-server.git
cd google-calendar-mcp-server- 安装依赖项：
npm install- 设置环境变量：
cp .env.example .env编辑 .env 使用您的特定设置创建文件。
- 构建项目：
npm run build- 启动服务器：
npm start发展：
npm run devOAuth设置
- 转到 谷歌云控制台
- 创建新项目
- 启用Google日历API和Google文档API
- 设置OAuth同意屏幕
- 创建OAuth 2.0凭据
- 将凭据添加到您的
.env文件
技术栈
- 运行时：使用TypeScript的Node.js
- 框架：Express.js
- 数据库：MongoDB
- 缓存：Redis
- 队列：公牛
- LLM框架：LangChain.js
- 认证：OAuth2.0
- 容器化：Docker和Docker Compose
有关技术选择的更多详细信息，请参阅 技术栈 文档。
发展路线图
- \[x\] 架构文档
- \[x\] 初始项目设置
- \[\]核心模块实现
- \[\]Google API集成
- \[\]型号适配器
- \[\]客户端接口
- \[\]调度程序实现
- \[\]测试和安全审查
- \[\]部署指南
贡献
欢迎投稿！请阅读我们的 贡献指南 有关我们的行为准则和提交pull请求流程的详细信息。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。