MCP Personal Calendar

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.

Category
Visit Server

README

个人日历MCP

这是一个可以自行搭建的日历MCP服务。可以让大模型自动管理你的日程和待办任务。

一、功能

(仅支持Caldav协议日历,其他协议的日历可靠性未测试)

  1. 查询指定日期范围内的所有日程(所有日历中的)。
  2. 查询指定日期范围内的所有待办事项(所有日历中的)。
  3. 批量创建日程和待办。
    • 支持位置信息添加
    • 支持智能时区调整
    • 可结合Dify、N8n等工具进行跨平台联动
    • 默认以北京时间创建日程
  4. 支持修改和删除日程。

二、部署方法

  1. 使用下列命令克隆源代码

    git clone https://github.com/Blacol/MCP-PersonalCalendar
    
  2. 在源代码所在目录创建config.json文件,以下是示例:

    {
     "calendar_url": "Caldav服务器地址",
     "calendar_username": "日历用户名",
     "calendar_password": "日历密码"
    }
    
  3. 运行下列指令安装依赖

    # 先创建一个虚拟环境
    python3 -m venv .venv
    # 进入虚拟环境(Linux)
    source .venv/bin/activate
    # 安装依赖
    uv pip install .
    # 运行程序
    uv run main.py
    
  4. 打开MCP客户端,配置信息

    本软件监听20002端口。在服务器上部署后记得放行对应端口。

    配置信息:

    {
       "mcpServers": {
         "PersonalCalendar": {
           "type": "sse",
           "url": "[服务器公网IP]:20002/sse"
         }
       }
    }
    
  5. 打开模型进行测试

    因部分模型提供商提供的模型无法感知时间,有两种解决方案:

    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大厦里
    

    示例 AI对话 运行效果

    添加不同时区的日程

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

    示例 AI对话 运行效果 (软件中默认将日程以北京时间显示,东京时间13点对应北京时间12点,纽约时间17点对应北京时间6点)

Recommended Servers

playwright-mcp

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.

Official
Featured
TypeScript
Magic Component Platform (MCP)

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.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

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.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
Kagi MCP Server

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.

Official
Featured
Python
graphlit-mcp-server

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.

Official
Featured
TypeScript
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

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.

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured