谷歌日历MCP服务器
此MCP服务器允许Claude与您的Google日历交互，启用列出事件、创建会议和查找空闲时间等功能。
先决条件
- Node.js（v16或更高版本）
- 克劳德桌面应用程序
- 谷歌云项目
- 已启用Google日历API
- OAuth 2.0凭据
安装说明
1.创建谷歌云项目
- 转到 谷歌云控制台
- 创建新项目或选择现有项目
- 启用Google日历API：
- 转到“API和服务”>“库” - 搜索“Google日历API” - 点击“启用”
2.配置OAuth同意屏幕
- 转到“API和服务”>“OAuth同意屏幕”
- 选择“外部”用户类型（除非您有Google Workspace组织）
- 填写所需信息：
- 应用程序名称 - 用户支持电子邮件 - 开发人员联系信息
- 添加以下范围：
- https://www.googleapis.com/auth/calendar - https://www.googleapis.com/auth/calendar.events
- 将您的电子邮件地址添加为测试用户
3.创建OAuth 2.0凭据
- 转到“API和服务”>“凭据”
- 点击“创建凭据”>“OAuth客户端ID”
- 选择“桌面应用程序”作为应用程序类型
- 命名您的客户（例如，“MCP日历客户端”）
- 点击“创建”
- 下载客户端配置文件（您需要客户端ID和客户端密码）
4.获取刷新令牌
- 创建一个名为的新文件
getToken.js:
const { google } = require('googleapis');
const http = require('http');
const url = require('url');
// Replace these with your OAuth 2.0 credentials
const CLIENT_ID = 'your-client-id';
const CLIENT_SECRET = 'your-client-secret';
const REDIRECT_URI = 'http://localhost:3000/oauth2callback';
// Configure OAuth2 client
const oauth2Client = new google.auth.OAuth2(
CLIENT_ID,
CLIENT_SECRET,
REDIRECT_URI
);
// Define scopes
const scopes = [
'https://www.googleapis.com/auth/calendar',
'https://www.googleapis.com/auth/calendar.events'
];
async function getRefreshToken() {
return new Promise((resolve, reject) => {
try {
// Create server to handle OAuth callback
const server = http.createServer(async (req, res) => {
try {
const queryParams = url.parse(req.url, true).query;
if (queryParams.code) {
// Get tokens from code
const { tokens } = await oauth2Client.getToken(queryParams.code);
console.log('\n=================');
console.log('Refresh Token:', tokens.refresh_token);
console.log('=================\n');
console.log('Save this refresh token in your configuration!');
// Send success response
res.end('Authentication successful! You can close this window.');
// Close server
server.close();
resolve(tokens);
}
} catch (error) {
console.error('Error getting tokens:', error);
res.end('Authentication failed! Please check console for errors.');
reject(error);
}
}).listen(3000, () => {
// Generate auth url
const authUrl = oauth2Client.generateAuthUrl({
access_type: 'offline',
scope: scopes,
prompt: 'consent' // Force consent screen to ensure refresh token
});
console.log('1. Copy this URL and paste it in your browser:');
console.log('\n', authUrl, '\n');
console.log('2. Follow the Google authentication process');
console.log('3. Wait for the refresh token to appear here');
});
} catch (error) {
console.error('Server creation error:', error);
reject(error);
}
});
}
// Run the token retrieval
getRefreshToken().catch(console.error);- 安装所需的依赖关系：
npm install googleapis- 使用您的OAuth凭据更新脚本：
- 替换 your-client-id 使用您的实际客户ID - 替换 your-client-secret 使用您的实际客户机密
- 运行脚本：
node getToken.js- 按照控制台中的说明进行操作：
- 复制提供的URL - 将其粘贴到浏览器中 - 完成Google身份验证过程 - 复制控制台中显示的刷新令牌
5.配置克劳德桌面
- 打开您的Claude Desktop配置文件：
对于MacOS：
code ~/Library/Application\ Support/Claude/claude_desktop_config.json对于Windows：
code %AppData%\Claude\claude_desktop_config.json- 添加或更新配置：
{
"mcpServers": {
"google-calendar": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/YOUR/build/index.js"
],
"env": {
"GOOGLE_CLIENT_ID": "your_client_id_here",
"GOOGLE_CLIENT_SECRET": "your_client_secret_here",
"GOOGLE_REDIRECT_URI": "http://localhost",
"GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
}
}
}
}- 保存文件并重新启动Claude Desktop
初始项目设置
- 为您的项目创建一个新目录：
mkdir google-calendar-mcp
cd google-calendar-mcp- 初始化一个新的npm项目：
npm init -y- 安装依赖项：
npm install @modelcontextprotocol/sdk googleapis google-auth-library zod
npm install -D @types/node typescript- 创建一个tsconfig.json文件：
{
"compilerOptions": {
"target": "ES2022",
"module": "Node16",
"moduleResolution": "Node16",
"outDir": "./build",
"rootDir": "./src",
"strict": true,
"esModuleInterop": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true
},
"include": ["src/**/*"],
"exclude": ["node_modules"]
}- 更新package.json：
{
"type": "module",
"scripts": {
"build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\""
}
}- 创建源目录：
mkdir src- 为本地开发创建.env文件（不要提交此文件）：
GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
GOOGLE_REDIRECT_URI=http://localhost
GOOGLE_REFRESH_TOKEN=your_refresh_token_here建立和运行
- 构建服务器：
npm run build- 当您打开Claude Desktop时，服务器将自动启动
可用工具
服务器提供以下工具：
list_events：列出指定时间范围内的日历事件create_event：创建新的日历事件update_event：更新现有日历事件delete_event：删除日历事件find_free_time：在日历中查找可用的时间段
Claude中的示例用法
设置后，您可以使用以下命令：
- “显示我下周的日历事件”
- “安排明天下午2点与\[email_id\]会面1小时”
- “今天下午找一个30分钟的免费时段”
- “将我下午3点的会议更新为下午4点”
- “取消ID为\[event_ID\]的会议”
故障排除
常见问题
- Claude中未出现的工具：
- 检查克劳德桌面日志： tail -f ~/Library/Logs/Claude/mcp*.log - 验证所有环境变量是否设置正确 - 确保index.js的路径是绝对正确的
- 身份验证错误：
- 验证您的OAuth凭据是否正确 - 检查刷新令牌是否有效 - 确保启用了所需的作用域
- 服务器连接问题：
- 检查服务器是否已成功构建 - 验证build/index.js上的文件权限（应该是755） - 尝试直接运行服务器： node /path/to/build/index.js
查看日志
要查看服务器日志，请执行以下操作：
# For MacOS/Linux:
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
# For Windows:
Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20环境变量
如果您遇到环境变量错误，请验证每个错误：
- GOOGLE_CLIENT_ID：应该以“123456789-…”开头
1.
- GOOGLE_REDIRECT_URI：应该是“http://localhost"
- GOOGLE_REFRESH_TOKEN：一个不会过期的长字符串
安全考虑
- 确保您的OAuth凭据安全
- 不将凭据提交到版本控制
- 对敏感数据使用环境变量
- 定期轮换刷新令牌
- 监控Google云控制台中API的使用情况
许可证
MIT许可证-有关详细信息，请参阅许可证文件。
支持
如果您遇到任何问题：
- 检查上面的故障排除部分
- 查看克劳德桌面日志
- 在GitHub上打开一个问题
- 联系维护人员