Metadata-Version: 2.5
Name: nextcloud-mcp-lite
Version: 0.3.3
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, write, create directory, delete, move, copy, find, rename, comment.
- **Calendar (CalDAV)**: list calendars, create/get/update/delete events with time-range queries.
- **Todos (CalDAV)**: create, get, update, complete, delete tasks.
- **Auto-Resolution**: Automatically discovers active calendars and filters out deleted/trash collections.
- **Lightweight**: BasicAuth, stdio and streamable-http transports, no 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
```
