Skip to main content

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

Project description

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 (uvx) 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 uvx if uv is installed:

uvx nextcloud-mcp-server

Docker Usage

Build

docker build -t tai040502/nextcloud-mcp-server:latest .

Run

docker run -i --rm \
  -e NEXTCLOUD_HOST=https://your-nextcloud.example.com \
  -e NEXTCLOUD_USERNAME=admin \
  -e NEXTCLOUD_PASSWORD=your-password \
  tai040502/nextcloud-mcp-server

MCP Client Configuration

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

Using UV

{
  "nextcloud-mcp-server": {
    "command": "uvx",
    "args": ["nextcloud-mcp-server"],
    "env": {
      "NEXTCLOUD_HOST": "https://your-nextcloud.example.com",
      "NEXTCLOUD_USERNAME": "admin",
      "NEXTCLOUD_PASSWORD": "your-password"
    }
  }
}

Using Docker

{
  "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",
      "tai040502/nextcloud-mcp-server"
    ]
  }
}

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)

Credits

Based on cbcoutinho/nextcloud-mcp-server.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nextcloud_mcp_server_tai040502-0.65.3.tar.gz (324.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nextcloud_mcp_server_tai040502-0.65.3-py3-none-any.whl (397.0 kB view details)

Uploaded Python 3

File details

Details for the file nextcloud_mcp_server_tai040502-0.65.3.tar.gz.

File metadata

  • Download URL: nextcloud_mcp_server_tai040502-0.65.3.tar.gz
  • Upload date:
  • Size: 324.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for nextcloud_mcp_server_tai040502-0.65.3.tar.gz
Algorithm Hash digest
SHA256 5673423131fe2c5abe27d8d10f3013386daac0dc40ace0545989bd0af3c32ad5
MD5 95836dcddd937134bc5853601e86241e
BLAKE2b-256 03a062cc63ac1d5e9ba730b88e1ae105041d4b68a3fb0bf60953ba406ea37a42

See more details on using hashes here.

File details

Details for the file nextcloud_mcp_server_tai040502-0.65.3-py3-none-any.whl.

File metadata

  • Download URL: nextcloud_mcp_server_tai040502-0.65.3-py3-none-any.whl
  • Upload date:
  • Size: 397.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for nextcloud_mcp_server_tai040502-0.65.3-py3-none-any.whl
Algorithm Hash digest
SHA256 38a252f8d35440410567fc256fd39fc0ab50ddfb20bc9737be815e3769407ce9
MD5 1b7a42980232ad8fabc9fe05a8287a82
BLAKE2b-256 421cb9e525abc48726d2e10aecd1f156ec2b02497ebb09a50628169d60296076

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page