👋 Introduction

MCP server for pCloud — manage trash, files, sharing, public links, and file rewind recovery from your AI assistant.

⚠️ Draft — not working yet. The authentication flow is under active development, so the server is not usable end-to-end yet. The docs below describe the intended surface.

mcp-pcloud is a Model Context Protocol server for pCloud. It exposes the pCloud API to your AI assistant — browse and manage files, share folders, mint public links, and recover deleted or earlier file versions through trash and rewind history.

✨ Features

🔐 Token auth — reads a bearer token from MCP_PCLOUD_TOKEN or ~/.config/pcloud/tokens.json.
🗑️ Trash & rewind recovery — restore deleted files and recover earlier versions from rewind history.
📁 Full file management — list, stat, copy, move, rename, and delete files and folders.
🤝 Sharing & public links — share folders and create or revoke public download links.
🌍 Dynamic API routing — respects pCloud's EU/US hostname split.

📦 Install

Add the server to your MCP client config:

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

See Installation for per-client setup and authentication details.

🧰 Tools

The server registers 27 tools across seven groups.

Trash

Tool	Description
`list_trash`	List all files currently in the pCloud trash
`restore_from_trash`	Restore a file from trash by file ID (`confirm`)

Rewind

Tool	Description
`list_rewind_events`	List version history (rewind events) for a file path
`restore_from_rewind`	Restore a file from rewind history to a new path (`confirm`)

User

Tool	Description
`get_user_info`	Get account info: email, quota, and plan

Files

Tool	Description
`list_folder`	List the contents of a folder
`get_file_stat`	Get metadata for a file or folder
`create_folder`	Create a folder (no-op if it already exists)
`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 (`confirm`)
`delete_folder`	Recursively delete a folder (`confirm`)
`get_file_link`	Get a download URL for a file
`get_checksum`	Get SHA256, SHA1, and MD5 checksums for a file

Tool	Description
`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 (`confirm`)

Public Links

Tool	Description
`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 (`confirm`)

Zip & Revisions

Tool	Description
`get_zip_link`	Get a download URL for a ZIP of files and/or folders
`list_revisions`	List all revisions for a file
`revert_revision`	Revert a file to a previous revision (`confirm`)

Tools marked (confirm) require confirm=true to execute their destructive action.

📖 More

Installation — per-client setup and authentication.
Troubleshooting — common issues and checks.

👋 Introduction

On this page