MCP server for pCloud — manage trash, rewind, and file recovery.

Website · Documentation

Features

• Trash management — list deleted files and restore them by ID from pCloud trash.
• Rewind recovery — browse version history for any file path and restore a previous version to a new location.
• File revisions — list all revisions for a file and revert to any prior state.
• Folder and file operations — list, stat, copy, move, rename, create, and delete files and folders.
• Sharing — share folders with other pCloud users, accept or decline incoming share requests, and remove active shares.
• Public links — create, list, and delete public download links for files and folders, with optional expiry and download limits.

Install

Add the server to your MCP client config:

{
  "mcpServers": {
    "mcp-pcloud": {
      "command": "npx",
      "args": ["-y", "@kud/mcp-pcloud"],
      "env": {
        "MCP_PCLOUD_TOKEN": "your-pcloud-token"
      }
    }
  }
}

Authentication is resolved from environment variables. Set one of:

• MCP_PCLOUD_TOKEN — a pCloud access token (simplest)
• MCP_PCLOUD_CLIENT_ID + MCP_PCLOUD_CLIENT_SECRET — OAuth credentials

Usage

Once configured, the following tools are available to your AI assistant:

| Tool | Description | | ----------------------- | -------------------------------------------------------- | | list_trash | List all files currently in pCloud trash | | restore_from_trash | Restore a file from trash by file ID | | list_rewind_events | List version history for a file path | | restore_from_rewind | Restore a file from its rewind history to a new path | | list_revisions | List all revisions for a file | | revert_revision | Revert a file to a previous revision | | get_user_info | Get account info: quota, email, and plan | | list_folder | List the contents of a folder | | get_file_stat | Get metadata for a file or folder | | create_folder | Create a folder | | copy_file | Copy a file to a new path | | move_file | Move a file to a new path | | rename_file | Rename a file | | delete_file | Permanently delete a file | | delete_folder | Recursively delete a folder and all its contents | | get_file_link | Get a download URL for a file | | get_checksum | Get SHA256, SHA1, and MD5 checksums for a file | | get_zip_link | Get a download URL for a ZIP archive of files or folders | | list_shares | List all active folder shares | | share_folder | Share a folder with another pCloud user | | accept_share | Accept an incoming share request | | decline_share | Decline an incoming share request | | remove_share | Remove an active share | | create_file_publink | Create a public download link for a file | | create_folder_publink | Create a public link for a folder | | list_publinks | List all active public links | | delete_publink | Delete a public link by its code |

Development

git clone https://github.com/kud/mcp-pcloud.git
cd mcp-pcloud
npm install
npm run dev

| Script | Purpose | | ------------------- | ------------------------------------------------- | | npm run dev | Run from source via tsx | | npm run build | Compile TypeScript to dist/ | | npm run typecheck | Type-check without emitting | | npm test | Run the test suite with Vitest | | npm run inspect | Launch the MCP inspector against the built server |

📚 Full documentation → mcp-pcloud/docs