nextcloud-calendar-mcp by IAMSamuelRodda - MCP Server

Nextcloud Calendar MCP Server

MCP (Model Context Protocol) server for Nextcloud Calendar integration via CalDAV, allowing AI assistants to manage your calendar events.

Features

Events: List, create, update, search, and delete calendar events
Calendars: List all available calendars
Date Ranges: Filter events by date range
Search: Full-text search across events
All-Day Events: Support for all-day and timed events
Timezone Support: Configurable timezone (defaults to Australia/Sydney)

Setup

1. Create an App Password (Recommended)

Using an app password is more secure than your main password:

Log into your Nextcloud instance
Go to Settings → Security → Devices & sessions
Enter a name (e.g., "Claude Code MCP") and click Create new app password
Copy the generated password

2. Install Dependencies

cd repos/nextcloud-calendar-mcp
uv venv .venv
source .venv/bin/activate
uv pip install -r requirements.txt

3. Configure Claude Code

Add to your Claude Code MCP settings (~/.claude/mcp_settings.json):

{
  "mcpServers": {
    "nextcloud-calendar": {
      "command": "/path/to/nextcloud-calendar-mcp/.venv/bin/python",
      "args": ["/path/to/nextcloud-calendar-mcp/nextcloud_calendar_mcp.py"],
      "env": {
        "NEXTCLOUD_URL": "https://your-nextcloud-instance.com",
        "NEXTCLOUD_USERNAME": "your-username",
        "NEXTCLOUD_PASSWORD": "your-app-password"
      }
    }
  }
}

Available Tools

Tool	Description
`nextcloud_list_calendars`	List all calendars
`nextcloud_list_events`	List events in date range
`nextcloud_get_event`	Get full event details
`nextcloud_create_event`	Create a new event
`nextcloud_update_event`	Update an existing event
`nextcloud_delete_event`	Delete an event
`nextcloud_search_events`	Search events by text

Usage Examples

Once configured, you can ask Claude:

"What's on my calendar this week?"
"Show me my events for tomorrow"
"Create a meeting with John next Tuesday at 2pm"
"Search for events about 'dentist'"
"Delete the event with UID xyz123"
"Move my 3pm meeting to 4pm"

CalDAV Endpoints

This MCP server connects to the standard Nextcloud CalDAV endpoint:

Base: https://your-nextcloud.com/remote.php/dav
Calendars: https://your-nextcloud.com/remote.php/dav/calendars/{username}/

License

MIT