mcp-pcloud

# mcp-pcloud A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [pCloud](https://www.pcloud.com/) cloud storage. Enables AI assistants like Claude to interact with your pCloud - listing files, creating folders, searching, sharing, and more. ## Installation ### Option 1: Via npm (Recommended) ```bash npx -y mcp-pcloud ``` Or install globally: ```bash npm install -g mcp-pcloud ``` Add to Claude Code: ```bash claude mcp add pcloud -e PCLOUD_USERNAME=you@example.com -e PCLOUD_PASSWORD=yourpassword -- npx -y mcp-pcloud ``` ### Option 2: From Source ```bash git clone https://github.com/fatherlinux/mcp-pcloud.git cd mcp-pcloud npm install npm run build ``` Add to Claude Code: ```bash claude mcp add pcloud -e PCLOUD_USERNAME=you@example.com -e PCLOUD_PASSWORD=yourpassword -- node /path/to/mcp-pcloud/dist/index.js ``` **For EU accounts:** Add `-e PCLOUD_API_HOST=eapi.pcloud.com` to either command. ## Authentication **Option 1: Username/Password** (recommended - no developer portal needed) ```bash export PCLOUD_USERNAME=your_email@example.com export PCLOUD_PASSWORD=your_password ``` **Option 2: Access Token** (requires [developer portal](https://docs.pcloud.com/my_apps/)) ```bash export PCLOUD_ACCESS_TOKEN=your_token ``` ## Available Tools | Tool | Description | |------|-------------| | `pcloud_list_folder` | List folder contents | | `pcloud_create_folder` | Create a folder | | `pcloud_delete_folder` | Delete a folder | | `pcloud_rename_folder` | Rename/move a folder | | `pcloud_copy_folder` | Copy a folder | | `pcloud_get_file_info` | Get file metadata | | `pcloud_delete_file` | Delete a file | | `pcloud_rename_file` | Rename/move a file | | `pcloud_copy_file` | Copy a file | | `pcloud_get_file_link` | Get temporary download link | | `pcloud_create_public_link` | Create public share link | | `pcloud_search` | Search files and folders | | `pcloud_read_text_file` | Read text file contents | | `pcloud_get_checksum` | Get file checksums | | `pcloud_get_user_info` | Get account info and quota | ## Example Usage Once configured, ask Claude: - "List my pCloud files" - "How much storage am I using?" - "Search for PDF files in pCloud" - "Create a folder called Backups" ## License GPL-3.0 - [fatherlinux](https://github.com/fatherlinux)