MCP Personal Calendar

MCP de Calendario Personal

Este es un servicio de calendario MCP que puedes alojar tú mismo. Permite que los modelos de lenguaje grandes gestionen automáticamente tu agenda y tus tareas pendientes.

I. Funciones

(Solo admite calendarios con protocolo CalDAV; no se ha probado la fiabilidad con otros protocolos)

1. Consultar todos los eventos dentro de un rango de fechas específico (en todos los calendarios).

2. Consultar todas las tareas pendientes dentro de un rango de fechas específico (en todos los calendarios).

3. Crear eventos y tareas pendientes por lotes.

   • Admite la adición de información de ubicación.

   • Admite ajustes inteligentes de zona horaria.

   • Se puede combinar con herramientas como Dify o N8n para la integración entre plataformas.

   • Por defecto, crea eventos en hora de Pekín.

4. Admite la modificación y eliminación de eventos.

II. Método de despliegue

1. Utiliza el siguiente comando para clonar el código fuente:

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

2. Crea un archivo config.json en el directorio donde se encuentra el código fuente; a continuación se muestra un ejemplo:

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

3. Ejecuta el siguiente comando para instalar las dependencias:

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

4. Abre el cliente MCP y configura la información:

   Este software escucha en el puerto 20002. Recuerda abrir el puerto correspondiente después de desplegarlo en el servidor.

   Información de configuración (CherryStudio):

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

   Información de configuración (otros clientes MCP):

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

5. Abre el modelo para realizar pruebas:

   Añadir múltiples eventos

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

   Ejemplo

   Añadir eventos en diferentes zonas horarias

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

   Ejemplo (El software muestra los eventos por defecto en hora de Pekín; las 13:00 en hora de Tokio corresponden a las 12:00 en hora de Pekín, y las 17:00 en hora de Nueva York corresponden a las 6:00 en hora de Pekín)