Metadata-Version: 2.3
Name: nextcloud-mcp-server-tai040502
Version: 0.65.6
Summary: Model Context Protocol (MCP) server for Nextcloud integration - enables AI assistants to interact with Nextcloud data
Keywords: nextcloud,mcp,model-context-protocol,llm,ai,claude,webdav,caldav,carddav
Author: Chris Coutinho
Author-email: Chris Coutinho <chris@coutinho.io>
License: AGPL-3.0-only
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Communications
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Dist: mcp[cli]>=1.26,<1.27
Requires-Dist: httpx>=0.28.1,<0.29.0
Requires-Dist: pillow>=10.3.0,<12.0.0
Requires-Dist: icalendar>=7.0.2,<7.1.0
Requires-Dist: pythonvcard4>=0.2.0
Requires-Dist: pydantic>=2.11.4
Requires-Dist: click>=8.1.8
Requires-Dist: caldav>=3.0.1,<4.0
Requires-Dist: pyjwt[crypto]>=2.8.0
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: alembic>=1.14.0
Requires-Dist: authlib>=1.6.5
Requires-Dist: qdrant-client>=1.17.0
Requires-Dist: fastembed>=0.7.3
Requires-Dist: anthropic>=0.42.0
Requires-Dist: boto3>=1.35.0
Requires-Dist: prometheus-client>=0.21.0
Requires-Dist: opentelemetry-api>=1.28.2
Requires-Dist: opentelemetry-sdk>=1.28.2
Requires-Dist: opentelemetry-instrumentation-asgi>=0.49b2
Requires-Dist: opentelemetry-instrumentation-httpx>=0.49b2
Requires-Dist: opentelemetry-instrumentation-logging>=0.49b2
Requires-Dist: opentelemetry-exporter-otlp-proto-grpc>=1.28.2
Requires-Dist: python-json-logger>=3.2.0
Requires-Dist: jinja2>=3.1.6
Requires-Dist: langchain-text-splitters>=1.0.0
Requires-Dist: markdownify>=0.14.1
Requires-Dist: pymupdf>=1.26.6
Requires-Dist: pymupdf4llm>=0.2.2
Requires-Dist: pymupdf-layout>=1.26.6
Requires-Dist: openai>=2.8.1
Requires-Python: >=3.11
Project-URL: Homepage, https://github.com/cbcoutinho/nextcloud-mcp-server
Project-URL: Documentation, https://github.com/cbcoutinho/nextcloud-mcp-server#readme
Project-URL: Repository, https://github.com/cbcoutinho/nextcloud-mcp-server
Project-URL: Bug Tracker, https://github.com/cbcoutinho/nextcloud-mcp-server/issues
Project-URL: Changelog, https://github.com/cbcoutinho/nextcloud-mcp-server/blob/master/CHANGELOG.md
Description-Content-Type: text/markdown

# Nextcloud MCP Server (STDIO Mode)

Model Context Protocol (MCP) server for Nextcloud integration - enables AI assistants to interact with Nextcloud data.

This is a **stdio mode** package designed for seamless Python execution (`uv tool run`) or Docker container deployment with AI assistants.

## Features

- **Notes** - Create, read, update, delete, search notes
- **Calendar** - Manage calendar events (CalDAV)
- **Contacts** - Manage contacts (CardDAV)
- **WebDAV** - Upload, download, manage files and folders
- **Deck** - Manage Kanban boards
- **Cookbook** - Manage recipes
- **Tables** - Manage data tables
- **Sharing** - Share files and folders
- **News** - Read RSS feeds

## Local / PyPI Usage (Recommended)

You can run this Server completely free of installation via `uv tool run` (or `uvx`) if `uv` is installed:

```bash
uv tool run nextcloud-mcp-server-tai040502
```

## MCP Client Configuration

For AI assistant integration (Claude Desktop, Gemini, etc.):

#### Using UV
```json
{
  "nextcloud-mcp-server": {
    "command": "uvx",
    "args": [
      "nextcloud-mcp-server-tai040502"
    ],
    "env": {
      "NEXTCLOUD_HOST": "https://your-nextcloud.example.com",
      "NEXTCLOUD_USERNAME": "admin",
      "NEXTCLOUD_PASSWORD": "your-password",
      "NEXTCLOUD_VERIFY_SSL": "false"
    }
  }
}
```

#### Using Docker
```json
{
  "nextcloud-mcp-server": {
    "command": "docker",
    "args": [
      "run", "-i", "--rm",
      "-e", "NEXTCLOUD_HOST=https://your-nextcloud.example.com",
      "-e", "NEXTCLOUD_USERNAME=admin",
      "-e", "NEXTCLOUD_PASSWORD=your-password",
      "-e", "NEXTCLOUD_VERIFY_SSL=false",
      "tai040502/nextcloud-mcp-server:latest"
    ]
  }
}
```

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `NEXTCLOUD_HOST` | Yes | Nextcloud instance URL |
| `NEXTCLOUD_USERNAME` | Yes | Nextcloud username |
| `NEXTCLOUD_PASSWORD` | Yes | Nextcloud password |
| `NEXTCLOUD_VERIFY_SSL` | No | Verify SSL certificates (default: `true`) |
