Skip to main content
Glama
Sign In
deenesjakoruzh

mcp-nextcloud-calendar

by Cheffromspace
npmGitHub
TypeScript
ISC License
35
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Includes support for Ko-fi donations through a button link in the README.

  • Provides tools for interacting with Nextcloud Calendar, enabling calendar management (listing, creating, updating, deleting calendars) and event management (listing, creating, retrieving, updating, deleting events), with ADHD-friendly organization features.

MCP Nextcloud 日历

用于 Nextcloud 日历集成的模型上下文协议 (MCP) 服务器。

特征

  • 从 Nextcloud 获取日历
  • 适合注意力缺陷多动障碍 (ADHD) 的组织功能
  • MCP 协议支持（可流式传输的 HTTP 和旧式 HTTP+SSE）

用法

与 npx 一起使用

使用此包的最简单方法是使用 npx：

npx mcp-nextcloud-calendar

安装

对于开发或本地安装：

# Install globally npm install -g mcp-nextcloud-calendar # Or install locally npm install mcp-nextcloud-calendar

MCP 客户端配置

要与 MCP 客户端（如 Claude）一起使用，请将此配置添加到您的 MCP 客户端设置中：

{ "mcpServers": { "nextcloud-calendar": { "command": "npx", "args": ["-y", "mcp-nextcloud-calendar"], "env": { "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com", "NEXTCLOUD_USERNAME": "your-username", "NEXTCLOUD_APP_TOKEN": "your-app-token" } } } }
指定版本

您可以固定到软件包的特定版本：

{ "mcpServers": { "nextcloud-calendar": { "command": "npx", "args": ["-y", "mcp-nextcloud-calendar@0.1.0"], "env": { "NEXTCLOUD_BASE_URL": "https://your-nextcloud-server.com", "NEXTCLOUD_USERNAME": "your-username", "NEXTCLOUD_APP_TOKEN": "your-app-token" } } } }

配置

环境变量

服务器使用这些环境变量，并尽可能使用默认值：

多变的描述默认必需的
港口服务器端口3001不
服务器名称MCP 服务器标识符NextCloud 日历服务器不
NODE_ENV环境（开发/生产）发展不
NEXTCLOUD_BASE_URL您的 Nextcloud 服务器 URL-是的
NEXTCLOUD_用户名您的 Nextcloud 用户名-是的
NEXTCLOUD_APP_TOKEN您的 Nextcloud 应用令牌-是的
保持活动间隔保持活动间隔（毫秒）30000不

开发设置

对于本地开发：

  1. 克隆存储库
  2. 安装依赖项：
npm install
  1. 在项目根目录中创建一个.env文件：
cp .env.example .env
  1. 使用您的 Nextcloud 凭据编辑.env文件。

获取 Nextcloud 应用令牌

  1. 登录到您的 Nextcloud 实例
  2. 前往“设置”→“安全”→“应用密码”
  3. 创建一个新的应用密码，名称例如“MCP 日历”
  4. 将生成的令牌复制到你的.env文件

发展

# Build the project npm run build # Run in development mode npm run dev # Run tests npm run test # Run linting npm run lint # Format code npm run format

API 端点

  • /mcp - 主 MCP 端点（可流式传输的 HTTP 传输）
  • /sse和/messages - 传统 MCP 端点（HTTP+SSE 传输）
  • GET /health - 健康检查端点
  • GET /api/calendars - 列出所有日历

MCP 工具

以下 MCP 工具已注册并可供客户使用：

日历管理

工具描述参数
listCalendars检索所有可访问的日历没有任何
createCalendar创建新日历displayName （必需）、 color （可选）、 category （可选）、 focusPriority （可选）
updateCalendar更新现有日历id （必需）、 displayName （可选）、 color （可选）、 category （可选）、 focusPriority （可选）
deleteCalendar删除日历id （必填）

⚠️ 权限警告： updateCalendar和deleteCalendar工具可能需要 Nextcloud 实例中的特殊权限。日历操作受 Nextcloud 权限系统的约束。

活动管理

工具描述参数
listEvents检索日历的事件calendarId （必需）、 start （可选）、 end （可选）
getEvent获取特定事件calendarId （必填）、 eventId （必填）
createEvent创建新事件calendarId （必填）、 summary （必填）、 start （必填）、 end （必填）、 description （可选）、 location （可选）
updateEvent更新现有事件calendarId （必需）、 eventId （必需），[以及要更新的任何事件属性]
deleteEvent删除事件calendarId （必填）、 eventId （必填）

已知问题和限制

注意：此软件包目前处于早期开发阶段（0.1.x）。API 和工具在未来版本中可能会有所变更，恕不另行通知。

  • 更新和删除日历操作可能需要 Nextcloud 实例中的特定权限
  • 特定 Nextcloud 错误代码的错误处理仍在改进中
  • 包含许多事件的大型日历可能会遇到性能问题

请在 GitHub 存储库上报告任何问题。

执照

国际学习中心

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

mcp-nextcloud-日历

  1. 特征
    1. 用法
      1. 与 npx 一起使用
      2. 安装
      3. MCP 客户端配置
    2. 配置
      1. 环境变量
      2. 开发设置
      3. 获取 Nextcloud 应用令牌
    3. 发展
      1. API 端点
        1. MCP 工具
          1. 日历管理
          2. 活动管理
        2. 已知问题和限制
          1. 执照

            Related MCP Servers

            • Google Workspace MCP Server

              epaproditus
              A
              security
              A
              license
              A
              quality
              Provides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.
              Last updated -
              8
              13
              JavaScript
              MIT License

            • Cal.com Calendar MCP Server

              mumunha
              -
              security
              F
              license
              -
              quality
              An MCP server that enables scheduling, updating, deleting, and listing calendar appointments through Cal.com's Calendar API.
              Last updated -
              JavaScript

            • GoogleCalendarMCP

              ITworkonline
              -
              security
              F
              license
              -
              quality
              A Model Completion Prompt (MCP) plugin that allows users to create events in Google Calendar with customizable attributes like times, description, location, attendees, and timezone.
              Last updated -
              Python
              • Linux
              • Apple

            View all related MCP servers

            New MCP Servers

            ID: dkbdpuhi9u