# Pastea MCP server

> Allows AI clients to search, read, and re-copy your Mac clipboard history and screenshot text locally.

- Repository: https://github.com/pastea-app/pastea-mcp
- Page: https://hostedmcp.org/servers/pastea-app/pastea-mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 1.0.4

## Install

### Claude Code

```sh
claude mcp add pastea-mcp -- npx -y @pastea/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "pastea-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pastea/mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "pastea-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pastea/mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"pastea-mcp","type":"stdio","command":"npx","args":["-y","@pastea/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "pastea-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pastea/mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add pastea-mcp -- npx -y @pastea/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.pastea-mcp]
command = "npx"
args = ["-y", "@pastea/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user pastea-mcp npx -- -y @pastea/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "pastea-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pastea/mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PASTEA_MCP_URL` | no | no |  |

## FAQ

### What can my AI assistant do with Pastea?

Your assistant can search clipboard history (including text in screenshots), read full clips with thumbnails, list collections, and put clips back onto your system clipboard.

### Is my clipboard data sent to the cloud?

No, the server runs locally on your Mac and only connects to Pastea on 127.0.0.1, making no external network requests.

### Does this work with free versions of Pastea?

No, MCP access requires a Pastea Pro subscription.

### Can the AI delete my clipboard history?

No, the AI assistant is restricted from deleting clips or seeing items concealed by Pastea, such as those from password managers.