MCP Personal Calendar

Personal Calendar MCP

This is a self-hostable calendar MCP service. It allows large language models to automatically manage your schedules and to-do lists.

Related MCP server: mcp-labrat

I. Features

(Only CalDAV protocol calendars are supported; reliability for other protocols has not been tested)

1. Query all schedules within a specified date range (across all calendars).

2. Query all to-do items within a specified date range (across all calendars).

3. Batch create schedules and to-dos.

   • Supports adding location information

   • Supports intelligent timezone adjustments

   • Can be integrated with tools like Dify and N8n for cross-platform automation

   • Schedules are created in Beijing Time by default

4. Supports modifying and deleting schedules.

II. Deployment

1. Clone the source code using the following command:

   git clone https://github.com/Blacol/MCP-PersonalCalendar

2. Create a config.json file in the directory where the source code is located. Here is an example:

   {
    "calendar_url": "Caldav服务器地址",
    "calendar_username": "日历用户名",
    "calendar_password": "日历密码",
    "default_remind_time": "-15m"
   }

3. Run the following command to install dependencies:

   # 先创建一个虚拟环境
   python3 -m venv .venv
   # 进入虚拟环境（Linux）
   source .venv/bin/activate
   # 安装依赖
   uv pip install -e .
   # 运行程序
   uv run main.py

4. Open your MCP client and configure the information.

   This software listens on port 20002. Remember to open the corresponding port after deploying on a server.

   Configuration (CherryStudio):

   {
      "mcpServers": {
        "PersonalCalendar": {
          "type": "sse",
          "url": "[服务器公网IP]:20002/sse"
        }
      }
   }

   Configuration (Other MCP clients):

   {
     "transport": "sse",
     "url": "[服务器公网IP]:20002/sse"
   }

5. Open the model to test.

   Add multiple schedules

   帮我把下面几个日程添加到测试用日历中：
   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大厦里

   Example

   Add schedules in different timezones

   帮我把下面几个日程添加到测试用日历中：
   1. 2025年11月4日 13:00-15:00（东京时间） 测试日程1
   2. 2025年11月4日 17:00-22:00（纽约时间） 测试日程2

   Example (The software displays schedules in Beijing Time by default; 13:00 Tokyo time corresponds to 12:00 Beijing time, and 17:00 New York time corresponds to 06:00 Beijing time)