English Français العربية

io.github.Vando-sketch/nextcloud-organizer-mcp

السجل الرسمي الإنتاجية

Manage Nextcloud tasks, calendar events and notes from Claude over CalDAV and the Notes API.

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.Vando-sketch/nextcloud-organizer-mcp؟

  • Tasks (VTODO): priorities, tags, reminders, subtasks, recurrence with exception dates, four-state status, batch update/delete/move.
  • Calendars and events (VEVENT): recurring events, attendees and RSVP, free/busy, sharing, ICS import/export, birthdays, batch operations, trash bin.
  • Timeboxing: turn a task into a calendar block and keep both linked.
  • Notes: create, search, append, replace a passage or a single Markdown section.
  • Combined day agenda: events and due tasks together.
  • Safe by default: OAuth 2.1 with a password consent page, https:// enforced for Nextcloud, clean error messages instead of stack traces.
  • 51 tools in total, documented in the tool reference.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package nextcloud-organizer-mcp
Claude Code 
claude mcp add nextcloud-organizer-mcp -e 'NEXTCLOUD_BASE_URL=<NEXTCLOUD_BASE_URL>' -e 'NEXTCLOUD_USERNAME=<NEXTCLOUD_USERNAME>' -e 'NEXTCLOUD_APP_PASSWORD=<your nextcloud_app_password>' -e 'PUBLIC_BASE_URL=<PUBLIC_BASE_URL>' -e 'MCP_OAUTH_PASSWORD=<your mcp_oauth_password>' -- uvx nextcloud-organizer-mcp==0.2.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "nextcloud-organizer-mcp": {
            "command": "uvx",
            "args": [
                "nextcloud-organizer-mcp==0.2.1"
            ],
            "env": {
                "NEXTCLOUD_BASE_URL": "<NEXTCLOUD_BASE_URL>",
                "NEXTCLOUD_USERNAME": "<NEXTCLOUD_USERNAME>",
                "NEXTCLOUD_APP_PASSWORD": "<your nextcloud_app_password>",
                "PUBLIC_BASE_URL": "<PUBLIC_BASE_URL>",
                "MCP_OAUTH_PASSWORD": "<your mcp_oauth_password>"
            }
        }
    }
}

متغيرات البيئة

  • NEXTCLOUD_BASE_URL إلزامي Base URL of your Nextcloud instance, e.g. https://cloud.example.com (must be https:// unless local).
  • NEXTCLOUD_USERNAME إلزامي Nextcloud username.
  • NEXTCLOUD_APP_PASSWORD إلزامي سري Nextcloud app password (Settings > Security > Devices & sessions), never the account password.
  • PUBLIC_BASE_URL إلزامي The exact public URL clients use to reach this server; required for the OAuth 2.1 flow.
  • MCP_OAUTH_PASSWORD سري Password for the OAuth consent page; required unless the server is bound and reached locally only.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. nextcloud-organizer-mcp
  2. What you can say
  3. Features
  4. Compatibility
  5. Quick start
  6. How it works
  7. Documentation
  8. License

nextcloud-organizer-mcp

Let Claude run your Nextcloud tasks, calendar and notes.

A self-hosted MCP server for CalDAV tasks, events and the Notes app.

Real tool calls against a real Nextcloud · watch as video

Ask in plain language, and your own Nextcloud changes. No copy-paste, no third-party calendar service: the data stays on your server and the tools talk to it over standard CalDAV and the Notes REST API.

Community project, not affiliated with or endorsed by Nextcloud GmbH. Formerly nextcloud-task-mcp.

What you can say

You sayWhat happens
"Add a high-priority task: finish the Q4 report by Thursday 5pm, remind me 2 hours before."create_task with due date, priority and a VALARM reminder
"Add a weekly team sync, Mondays 10:00."create_event with an RRULE
"Block Thursday 9-11 for the report."create_event_from_task — a linked time block, task and event stay connected
"What does my Thursday look like?"get_agenda — events (recurring ones expanded) and due tasks in one answer
"Start a note for the Q4 report, then update just the status section."create_note, update_note_section

What Claude wrote shows up in the normal Nextcloud apps, immediately:

Features

  • Tasks (VTODO): priorities, tags, reminders, subtasks, recurrence with exception dates, four-state status, batch update/delete/move.
  • Calendars and events (VEVENT): recurring events, attendees and RSVP, free/busy, sharing, ICS import/export, birthdays, batch operations, trash bin.
  • Timeboxing: turn a task into a calendar block and keep both linked.
  • Notes: create, search, append, replace a passage or a single Markdown section.
  • Combined day agenda: events and due tasks together.
  • Safe by default: OAuth 2.1 with a password consent page, https:// enforced for Nextcloud, clean error messages instead of stack traces.
  • 51 tools in total, documented in the tool reference.

Compatibility

ClientStatus
Claude (claude.ai web) as a custom connectorSupported, connector and consent flow tested against claude.ai
Claude mobile and CoworkUse the same connector as web; not tested separately
Claude Desktop via mcp-remoteDocumented in the deployment guide
Other MCP clients and model providersNot tested yet, planned

The server speaks standard Streamable HTTP MCP with OAuth 2.1 (Dynamic Client Registration + PKCE), so other clients may work. The OAuth redirect allow-list defaults to claude.ai and claude.com; other clients need MCP_OAUTH_ALLOWED_REDIRECT_DOMAINS set. Reports from other clients are welcome.

Quick start

Requires Python 3.10+ and a Nextcloud with the Calendar/Tasks and Notes apps.

uv tool install nextcloud-organizer-mcp   # or: pipx install nextcloud-organizer-mcp

Create an app password under Settings → Security → Devices & sessions (never your account password), then set:

export NEXTCLOUD_BASE_URL=https://cloud.example.com
export NEXTCLOUD_USERNAME=your-username
export NEXTCLOUD_APP_PASSWORD=your-app-password
export PUBLIC_BASE_URL=https://your-host.ts.net   # the URL clients use
export MCP_OAUTH_PASSWORD=a-long-random-password  # required unless local
nextcloud-organizer-mcp     # listens on 127.0.0.1:8000, path /mcp

From a checkout instead: uv sync && cp .env.example .env, edit .env, then uv run nextcloud-organizer-mcp. Every setting is documented in .env.example. NEXTCLOUD_BASE_URL must be https:// unless it points at a local address.

Then expose the server (the deployment guide uses Tailscale Funnel for TLS) and add it in Claude under Settings → Connectors → Add custom connector with the URL <PUBLIC_BASE_URL>/mcp. Leave Client ID and Secret blank and enter your MCP_OAUTH_PASSWORD on the consent page that opens. Details: Authentication.

How it works

Claude ── HTTPS + OAuth 2.1 ──► your server (this project) ── CalDAV / Notes API ──► Nextcloud
  • One CalDAV connection is opened at startup and reused for every request.
  • No tool or CalDAV logic runs until a request carries a valid access token.
  • The server binds to a local HTTP port and does not handle TLS itself.
  • Timestamps use MCP_DEFAULT_TIMEZONE (default Europe/Berlin); naive inputs are interpreted in it.

Documentation

License

MIT

الأسئلة الشائعة

ما هو io.github.Vando-sketch/nextcloud-organizer-mcp؟

Manage Nextcloud tasks, calendar events and notes from Claude over CalDAV and the Notes API.

كيف أثبّت io.github.Vando-sketch/nextcloud-organizer-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add nextcloud-organizer-mcp -e 'NEXTCLOUD_BASE_URL=<NEXTCLOUD_BASE_URL>' -e 'NEXTCLOUD_USERNAME=<NEXTCLOUD_USERNAME>' -e 'NEXTCLOUD_APP_PASSWORD=<your nextcloud_app_password>' -e 'PUBLIC_BASE_URL=<PUBLIC_BASE_URL>' -e 'MCP_OAUTH_PASSWORD=<your mcp_oauth_password>' -- uvx nextcloud-organizer-mcp==0.2.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Vando-sketch/nextcloud-organizer-mcp إلى مفتاح API؟

نعم. يتطلب NEXTCLOUD_BASE_URL, NEXTCLOUD_USERNAME, NEXTCLOUD_APP_PASSWORD, PUBLIC_BASE_URL, MCP_OAUTH_PASSWORD، وتضبطها في إعداداته.

هل io.github.Vando-sketch/nextcloud-organizer-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.Vando-sketch/nextcloud-organizer-mcp؟

ينشره Vando-sketch. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.