Overview
What is MCP Nextcloud Calendar?
MCP Nextcloud Calendar is a Model Context Protocol (MCP) server that integrates with Nextcloud Calendar, enabling AI assistants to manage calendars and events. It supports ADHD-friendly organization features and uses Streamable HTTP or legacy HTTP+SSE transports.
How to use MCP Nextcloud Calendar?
Run instantly with npx mcp-nextcloud-calendar or install via npm install mcp-nextcloud-calendar. Configure required environment variables (NEXTCLOUD_BASE_URL, NEXTCLOUD_USERNAME, NEXTCLOUD_APP_TOKEN) in an MCP client’s settings. The server exposes endpoints at /mcp (Streamable HTTP) and /sse + /messages (legacy).
Key features of MCP Nextcloud Calendar
- Fetch all accessible calendars from Nextcloud.
- Create, update, and delete calendars.
- Create, update, delete, and list events per calendar.
- Retrieve a single event by ID.
- ADHD-friendly organization fields (category, focusPriority).
Use cases of MCP Nextcloud Calendar
- An AI assistant manages a user’s Nextcloud calendar directly from a chat interface.
- Automatically create and update events with summaries, locations, and descriptions.
- Organize calendars with custom categories and focus priorities.
FAQ from MCP Nextcloud Calendar
How do I get a Nextcloud app token?
Go to Settings → Security → App Passwords in your Nextcloud instance, create a new app password, and copy the generated token.
What environment variables are required?
NEXTCLOUD_BASE_URL, NEXTCLOUD_USERNAME, and NEXTCLOUD_APP_TOKEN are required. PORT (default 3001) and KEEP_ALIVE_INTERVAL (default 30000 ms) are optional.
What MCP transports does MCP Nextcloud Calendar support?
It supports Streamable HTTP (endpoint /mcp) and legacy HTTP+SSE (endpoints /sse and /messages).
Can I update or delete calendars with MCP Nextcloud Calendar?
Yes, but these operations may require special permissions in your Nextcloud instance, and the tools are subject to Nextcloud’s permission system.
Is MCP Nextcloud Calendar production-ready?
It is currently in early development (version 0.1.x). APIs and tools may change without notice, and error handling for specific Nextcloud error codes is still being improved.
