mcp-pcloud — Erwann Mest

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