synology-calendar-mcp

synology-calendar-mcp

MCP server that exposes Synology Calendar (CalDAV) operations as tools, enabling listing calendars and creating, querying, deleting events with timezone handling.

Category
Visit Server

README

synology-calendar-mcp(Synology Calendar CalDAV MCP 服务)

English version: README.en.md

一个用 Python 实现的 Synology Calendar(CalDAV)MCP 服务,把群晖日历的增删查改封装为 MCP 工具,技术栈为官方 mcp SDK + caldav 库。

所有敏感配置(NAS 地址、DSM 账号、密码)放在 .env 里,绝不写进代码


工具

工具 说明 关键参数
calendar_list_calendars 列出所有日历
calendar_create_event 新建事件 title, dtstart, dtend, cal_id(默认 ueakup), location, uid
calendar_list_events 列出某日历事件(可按日期范围筛选) cal_id, start, end
calendar_get_event 按 UID 取单个事件 uid, cal_id
calendar_delete_event 按 UID 删除事件 uid, cal_id

时间默认按 UTC+8(Asia/Shanghai) 处理,格式 YYYY-MM-DDTHH:MM[:SS]


安装

git clone <your-repo> synology-calendar-mcp
cd synology-calendar-mcp
bash install.sh          # 建 .venv、装依赖、生成 .env(从 .env.example)
vim .env                 # 填入 SYNOLOGY_URL / SYNOLOGY_USER / SYNOLOGY_PASSWORD
SYNOLOGY_URL=https://nas.yourdomain.com
SYNOLOGY_USER=your-dsm-username
SYNOLOGY_PASSWORD=your-dsm-password
SYNOLOGY_DEFAULT_CAL_ID=ueakup

在 MCP 宿主中注册(stdio)

command 指向本项目的 synology-calendar.sh(会自动加载 .env):

{
  "mcpServers": {
    "synology-calendar": {
      "command": "/abs/path/to/synology-calendar-mcp/synology-calendar.sh",
      "args": []
    }
  }
}

也可由宿主直接注入 SYNOLOGY_* 环境变量,本项目 server 会优先使用宿主注入的值。

Hermes Agent

Hermes 通过 stdio 加载本服务。将 command 指向项目的 synology-calendar.sh (自动加载 .env),凭据通过 env 注入:

hermes config set mcp_servers.synology-calendar.command "/abs/path/to/synology-calendar-mcp/synology-calendar.sh"
hermes config set mcp_servers.synology-calendar.args ""
hermes config set mcp_servers.synology-calendar.env '{"SYNOLOGY_URL": "https://nas.yourdomain.com", "SYNOLOGY_USER": "your-dsm-username", "SYNOLOGY_PASSWORD": "your-dsm-password"}'
hermes gateway restart

args 必须留空字符串。凭据也可改为引用宿主 .env 变量(如 "SYNOLOGY_PASSWORD": "${SYNOLOGY_PASSWORD}"),由 Hermes 启动时展开。


许可证

MIT

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
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
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
E2B

E2B

Using MCP to run code via e2b.

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
Qdrant Server

Qdrant Server

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

Official
Featured