Metadata-Version: 2.5
Name: nextcloud-mcp-lite
Version: 0.3.4
Summary: Minimal MCP server for Nextcloud file sync and PIM
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: httpx<0.29,>=0.28.1
Requires-Dist: icalendar<7.4,>=7.3.0
Requires-Dist: mcp[cli]<3,>=2.1
Description-Content-Type: text/markdown

# nextcloud-mcp-lite

Minimal, fast Model Context Protocol (MCP) server for Nextcloud file sync and PIM (Calendar & Tasks).

## Features

- **Files (WebDAV)**: list, read (with `max_bytes` context guard), write, create directory, delete, move, copy, recursive find (`find_files`), rename, file comments.
- **Calendar (CalDAV)**: list calendars, create/get/update/delete events with recurrence (`rrule`), status, and time-range queries.
- **Todos (CalDAV)**: create, get, update, complete, and delete tasks with priority (0-9) and status filtering (`pending` / `COMPLETED`).
- **Auto-Resolution & Clean Paths**: Automatically discovers active calendars (filtering deleted/trash collections) and normalizes paths cleanly for seamless LLM tool chaining.
- **Lightweight**: BasicAuth, stdio and streamable-http transports, zero bloat.

## Installation

```bash
uv tool install nextcloud-mcp-lite
# or
pip install nextcloud-mcp-lite
```

## Configuration

Set the following environment variables:

- `NEXTCLOUD_HOST`: URL of your Nextcloud instance (e.g. `https://cloud.example.com`)
- `NEXTCLOUD_USERNAME`: Your Nextcloud username
- `NEXTCLOUD_PASSWORD`: App password from Nextcloud *Settings > Security > Devices & sessions*
- `NEXTCLOUD_VERIFY_SSL`: Set to `false` for self-signed certificates (default: `true`)

## Usage

```bash
nextcloud-mcp-lite run --transport stdio
# or
nextcloud-mcp run --transport stdio
```
