MCP Personal Calendar
A CalDAV-compliant MCP server that enables AI models to manage personal schedules and to-do lists, supporting batch creation, modification, and intelligent timezone adjustments.
README
个人日历MCP
这是一个可以自行搭建的日历MCP服务。可以让大模型自动管理你的日程和待办任务。
一、功能
(仅支持Caldav协议日历,其他协议的日历可靠性未测试)
- 查询指定日期范围内的所有日程(所有日历中的)。
- 查询指定日期范围内的所有待办事项(所有日历中的)。
- 批量创建日程和待办。
- 支持位置信息添加
- 支持智能时区调整
- 可结合Dify、N8n等工具进行跨平台联动
- 默认以北京时间创建日程
- 支持修改和删除日程。
二、部署方法
-
使用下列命令克隆源代码
git clone https://github.com/Blacol/MCP-PersonalCalendar -
在源代码所在目录创建
config.json文件,以下是示例:{ "calendar_url": "Caldav服务器地址", "calendar_username": "日历用户名", "calendar_password": "日历密码" } -
运行下列指令安装依赖
# 先创建一个虚拟环境 python3 -m venv .venv # 进入虚拟环境(Linux) source .venv/bin/activate # 安装依赖 uv pip install . # 运行程序 uv run main.py -
打开MCP客户端,配置信息
本软件监听20002端口。在服务器上部署后记得放行对应端口。
配置信息:
{ "mcpServers": { "PersonalCalendar": { "type": "sse", "url": "[服务器公网IP]:20002/sse" } } } -
打开模型进行测试
因部分模型提供商提供的模型无法感知时间,有两种解决方案:1. 创建日程时指定时间2. 自己再启用一个时间MCP从v1.1.0版本开始内部提供一个获取当前时间的工具,无需外部配置。
添加多个日程
帮我把下面几个日程添加到测试用日历中: 1. 2025年11月4日 13:00-15:00 测试日程1 2. 2025年11月4日 17:00-22:00 测试日程2 3. 2025年11月5日 8:00-11:30 测试日程3,地点在A市的B大厦里示例

添加不同时区的日程
帮我把下面几个日程添加到测试用日历中: 1. 2025年11月4日 13:00-15:00(东京时间) 测试日程1 2. 2025年11月4日 17:00-22:00(纽约时间) 测试日程2示例
(软件中默认将日程以北京时间显示,东京时间13点对应北京时间12点,纽约时间17点对应北京时间6点)
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
E2B
Using MCP to run code via e2b.