pCloud MCP server
Commit Nov 13, 2026Manage pCloud files, recover deleted items from trash, and restore previous file versions through an AI assistant.
Also known as kud/mcp-pcloud
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 13, 2026
- License
- MIT
What is pCloud MCP?
pCloud manages pCloud files, recover deleted items from trash, and restore previous file versions through an AI assistant.
Summary generated from the project's README
About pCloud MCP server
Managing cloud storage and recovering lost data through an AI assistant is what mcp-pcloud enables for pCloud users. This server provides a bridge between your AI client and your pCloud account, allowing you to perform complex file operations using natural language. You can handle standard tasks like creating folders, moving files, or renaming items, while also accessing advanced recovery features like browsing version history or restoring items from the trash.
To set this up, you must add the server to your MCP client configuration using npx. Authentication requires either a pCloud access token via the MCP_PCLOUD_TOKEN environment variable or OAuth credentials including a client ID and client secret. Once connected, the assistant can use specific tools to manage public download links, handle folder sharing requests, and even retrieve file checksums like SHA256 or MD5.
What you can do with it
- 1Recovering deleted filesAsk your AI to find and restore a specific file that was recently moved to the trash.
- 2Restoring previous file versionsInstruct the assistant to revert a file to an earlier state using its rewind history or revisions.
- 3Managing file sharingRequest the assistant to create a public download link for a folder with specific limits.
- 4Organizing cloud storageHave the AI assistant move, rename, or copy files across different directories in your account.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
MCP_PCLOUD_TOKEN
| Name | Description | |
|---|---|---|
| MCP_PCLOUD_TOKEN | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablekud/mcp-pcloud is public and reachablegithub.com/kud/mcp-pcloud ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/kud/mcp-pcloud ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub
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
pCloud MCP questions
How can I recover deleted files in pCloud?
You can list files currently in the trash and restore them using their specific file ID.
Can I restore an older version of a file?
Yes, you can browse version history for a file path and restore a previous version to a new location using the rewind feature.
What authentication methods are supported?
The server supports pCloud access tokens or OAuth credentials using a Client ID and Client Secret.