# mcp-pcloud

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [pCloud](https://www.pcloud.com/) 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)

```bash
npx -y mcp-pcloud
```

Or install globally:

```bash
npm install -g mcp-pcloud
```

Add to Claude Code:

```bash
claude mcp add pcloud -e PCLOUD_USERNAME=you@example.com -e PCLOUD_PASSWORD=yourpassword -- npx -y mcp-pcloud
```

### Option 2: From Source

```bash
git clone https://github.com/fatherlinux/mcp-pcloud.git
cd mcp-pcloud
npm install
npm run build
```

Add to Claude Code:

```bash
claude mcp add pcloud -e PCLOUD_USERNAME=you@example.com -e PCLOUD_PASSWORD=yourpassword -- node /path/to/mcp-pcloud/dist/index.js
```

**For 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](https://docs.pcloud.com/my_apps/))
```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](https://github.com/fatherlinux)