mcp-pcloud
A Model Context Protocol (MCP) server for pCloud 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)
npx -y mcp-pcloudOr install globally:
npm install -g mcp-pcloudAdd to Claude Code:
claude mcp add pcloud -e PCLOUD_USERNAME=you@example.com -e PCLOUD_PASSWORD=yourpassword -- npx -y mcp-pcloudOption 2: From Source
git clone https://github.com/fatherlinux/mcp-pcloud.git
cd mcp-pcloud
npm install
npm run buildAdd to Claude Code:
claude mcp add pcloud -e PCLOUD_USERNAME=you@example.com -e PCLOUD_PASSWORD=yourpassword -- node /path/to/mcp-pcloud/dist/index.jsFor 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) ``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
