TimeTree MCP服务器
英语
⚠️ 免责声明：这是一个 非官方 TimeTree MCP服务器 仅供个人使用.不隶属于TimeTree，股份有限公司可能随时中断。看 免责声明.md 了解全部细节。
一个非官方的MCP（模型上下文协议）服务器，允许MCP客户端（Claude Desktop、Claude Code、Codex、Antigravity、Cline、Cursor、Windsurf等）访问您的TimeTree日历数据。
特性
- 📅 列出日历 -获取所有TimeTree日历
- 📆 获取活动 -通过自动分页从任何日历中检索事件
- ➕ 创建活动 -将新事件添加到日历中
- ✏️ 更新事件 -修改现有事件
- 🗑️ 删除事件 -从日历中删除事件
- 🔐 安全认证 -电子邮件/密码验证（仅存储在MCP配置中）
- ⚡ 速率限制 -防止API过载的令牌桶算法
- 🔄 自动分页 -自动获取多个页面上的所有事件
- 🛡️ 错误处理 -通过用户友好的消息进行全面的错误处理
- 📝 结构化日志记录 -带有敏感数据屏蔽的详细日志
需求
- Node.js>=18.0.0
- Git（用于安装）
- TimeTree帐户
- 兼容MCP的客户端（Claude Desktop、Claude Code、Codex、Antigravity、Cline等）
安装
快速安装（推荐）
单线安装 -自动克隆、构建、运行 npm link，并打印客户端配置示例：
curl -fsSL https://raw.githubusercontent.com/ehs208/TimeTree-MCP/main/TimeTree-MCP-install.sh | bash脚本将链接 timetree-mcp 使用以下命令进入本地npm环境 npm link，然后显示所有支持的MCP客户端的配置说明。只需复制客户端的配置并添加TimeTree凭据。
手动安装
Click to expand manual installation steps
- 克隆和构建：
git clone https://github.com/ehs208/TimeTree-MCP.git
cd TimeTree-MCP
npm install
npm run build- 链接本地包
npx用法：
npm link- 配置您的MCP客户端：
看 配置 下面的部分设置您的MCP客户端。
配置
快速示例（Claude Desktop-macOS）：
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"timetree": {
"command": "npx",
"args": ["timetree-mcp"],
"env": {
"TIMETREE_EMAIL": "your-email@example.com",
"TIMETREE_PASSWORD": "your-password"
}
}
}
}这在一次性之后有效 npm link 上一步。然后重新启动克劳德桌面（Cmd+Q并重新打开）。
📖 对于所有MCP客户端（Claude Desktop Windows、Claude Code CLI、Codex、Antigravity、VS Code编辑器等）： → See docs/MCP_CLIENTS.md 有关详细的配置说明
更新
要更新到最新版本：
cd /path/to/TimeTree-MCP # or your installation path
git pull origin main
npm install
npm run build然后重新启动MCP客户端。
📖 有关详细的更新说明和故障排除： → See docs/UPDATING.md
用法
📖 看 COMMANDS.md 有关详细的使用示例和工作流程
MCP工具
- 列表_日历 -列出所有参与用户的日历
- get_events -从具有自动分页功能的日历中获取事件
- get_updated_events -在特定时间戳后更新事件（高效增量同步）
- create_event -在日历中创建新事件
- update_事件 -更新现有事件
- 删除事件 -从日历中删除事件
📖 看 COMMANDS.md 有关参数和使用细节。
发展
# Build the project
npm run build
# Watch mode (auto-rebuild on changes)
npm run dev局限性
- 非官方API：如果TimeTree更改其内部API，则可能会中断
- 速率限制：10个请求/秒（429个错误自动重试）
- 无官方支持：TimeTree不正式支持此工具
- 需要CSRF令牌：写入操作需要CSRF令牌（从TimeTree网页自动提取）
安全
- 凭据已存储 仅 在本地MCP配置中
- 会话Cookie仅存储在内存中（从不持久化到磁盘）
- 日志中会自动屏蔽密码和会话ID
- 所有通信都使用HTTPS
故障排除
“缺少必需的环境变量”错误
确保 TIMETREE_EMAIL 和 TIMETREE_PASSWORD 在MCP配置中设置。
身份验证失败
- 验证您的电子邮件和密码是否正确
- 检查您是否可以登录TimeTree web应用程序
- TimeTree可能已更改其身份验证API
未返回日历或事件
- 验证您的TimeTree帐户中是否有日历/事件
- 检查日志以了解详细的错误消息
- API可能已更改
贡献
欢迎投稿！拜托：
- 分叉存储库
- 创建要素分支
- 进行更改
- 提交拉取请求
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
免责声明
看 免责声明.md 获取重要的法律和使用信息。
______________________________________________________________________
不隶属于时代树公司。
这是一个由社区维护的独立项目。