{
  "markdown": "# Pastea MCP\n\n[![GitHub release](https://img.shields.io/github/v/release/pastea-app/pastea-mcp?label=release)](https://github.com/pastea-app/pastea-mcp/releases/latest)\n[![npm version](https://img.shields.io/npm/v/%40pastea%2Fmcp.svg)](https://www.npmjs.com/package/@pastea/mcp)\n[![CI](https://github.com/pastea-app/pastea-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/pastea-app/pastea-mcp/actions/workflows/ci.yml)\n[![license](https://img.shields.io/github/license/pastea-app/pastea-mcp.svg)](LICENSE)\n\n**Local MCP server for [Pastea](https://pastea.app).** Give Claude, Cursor, Codex, VS Code and\nother AI tools access to your Mac's clipboard history — without anything leaving your Mac.\n\nYour assistant can search what you copied, pull a clip into context (including the text\nPastea reads inside your screenshots), and put a clip back on the clipboard for you to paste.\n\nPastea runs the MCP server itself, on `127.0.0.1` only. This package is the thin,\ndependency-free bridge that AI apps launch: it finds Pastea, asks it for access once —\n**you click Allow in Pastea** — and relays messages over stdio.\n\n## Install\n\n### Claude Desktop\n\nOne click from Pastea: open **Settings → MCP & AI Tools**, turn on **Enable MCP**, and click\n**Claude Desktop**. Claude Desktop opens with the Pastea extension ready to install.\n\nOr find **Pastea** in Claude Desktop under **Settings → Extensions → Browse extensions**, or\ndownload `pastea-mcp-<version>.mcpb` from the\n[latest release](https://github.com/pastea-app/pastea-mcp/releases/latest) and double-click it.\n\nThe first time Claude uses it, Pastea asks you to allow the connection.\n\n### Every other AI app\n\nUse [`add-mcp`](https://www.npmjs.com/package/add-mcp) to connect Pastea to all your installed\nAI apps at once:\n\n```bash\nnpx add-mcp @pastea/mcp\n```\n\nOr connect each app yourself:\n\n**Claude Code**\n\n```bash\nclaude mcp add pastea -- npx -y @pastea/mcp\n```\n\n**Codex**\n\n```bash\ncodex mcp add pastea -- npx -y @pastea/mcp\n```\n\n**Cursor**\n\n[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=pastea&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBwYXN0ZWEvbWNwIl19)\n\n**VS Code**\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=pastea&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40pastea%2Fmcp%22%5D%7D)\n\n**Anything else** that runs stdio MCP servers:\n\n```json\n{ \"mcpServers\": { \"pastea\": { \"command\": \"npx\", \"args\": [\"-y\", \"@pastea/mcp\"] } } }\n```\n\nThe first time an app uses Pastea, Pastea shows **\"Allow &lt;app&gt; to use your clipboard\nhistory?\"** — click Allow and the tools appear.\n\n### Connect from Pastea\n\nEvery app above can also be connected from inside Pastea — **Settings → MCP & AI Tools**,\nclick the app's chip. Cursor and VS Code open an install prompt; Claude Code, Windsurf and\nCodex get the exact command or config to paste, already carrying an access token, so no\npairing prompt is needed.\n\n![Pastea's MCP & AI Tools settings page](assets/connect-ai-tools.png)\n\n## What your assistant can do\n\n| Tool | What it does |\n| --- | --- |\n| `search_clips` | Search your clipboard history and lists — text, links, file names, and text recognized in screenshots. |\n| `get_clip` | Read one clip in full, with a thumbnail for pictures. |\n| `list_collections` | List your history and the lists you made, with counts. |\n| `copy_clip` | Put a clip back on the system clipboard, exactly as copied. You paste it yourself with ⌘V. |\n| `pastea_status` | Says whether Pastea is reachable and connected, and what to do if not. |\n\nAn AI tool can **never** delete a clip, never pastes into another app, and never sees items\nPastea conceals (from password managers).\n\n## How pairing works\n\nThe bridge ships with no credentials. On first use it asks Pastea for access and Pastea shows\n**\"Allow Claude Desktop to use your clipboard history?\"** (or Cursor, Codex, …). Click Allow\nand the tools appear a moment later; click Don't Allow and nothing is granted — the assistant\ngets a `pastea_status` tool that explains the situation.\n\nConnections are listed in Pastea → **Settings → MCP & AI Tools → Connected AI Tools**, where\nyou can **Revoke** each one. Pastea then asks again only if you ask the assistant to reconnect.\n\n## Requirements\n\n- **macOS 15** or later\n- **[Pastea](https://pastea.app) 1.3+** with **Pastea Pro**, and **Enable MCP** turned on in\n  Settings → MCP & AI Tools\n- For `npx` installs: **Node.js 20+** (Claude Desktop needs nothing — it ships its own)\n\n## Privacy Policy\n\nPastea MCP runs locally on your Mac.\n\n- It connects only to Pastea on `127.0.0.1` and to nothing else. It makes no network\n  requests to Nexo Labs or any third party, and carries no analytics or telemetry.\n- It moves clipboard data only between Pastea and the AI app that runs it, and only after\n  you clicked Allow in Pastea. What that AI app does with clips it reads is governed by that\n  app's own privacy policy.\n- It stores one thing: the access token Pastea issued when you clicked Allow, in\n  `~/Library/Application Support/Pastea/MCP Bridge/tokens.json`, readable by your user\n  account only. Revoking the connection in Pastea invalidates it immediately; uninstalling\n  Pastea removes the file.\n- Concealed clips are never available to it, and it cannot delete anything.\n\nFull policy — what data Pastea processes, how it is stored, sharing, retention, and contact:\n**<https://pastea.app/privacy>**.\n\n## Troubleshooting\n\n**\"Pastea isn't running, or its MCP endpoint is turned off.\"**\nOpen Pastea and turn on **Enable MCP** in Settings → MCP & AI Tools, then ask the assistant to\ncall `pastea_status`.\n\n**\"Pastea Pro is required.\"**\nMCP access is a Pro feature. Subscribe in Pastea's Settings, then call `pastea_status`.\n\n**\"Pastea is asking the user to allow this connection.\"**\nLook for the Pastea window — it may be behind the AI app — and click **Allow**.\n\n**The tools vanished.**\nThe connection was revoked in Pastea, or Pastea was reset. Ask the assistant to call\n`pastea_status` to pair again.\n\n**Tools don't show up after connecting.**\nFully quit and reopen the AI app so it relaunches the bridge.\n\n**Changed Pastea's port?**\nThe bridge reads it from Pastea's preferences on every launch; restart the AI app.\n\nLogs for Claude Desktop: `~/Library/Logs/Claude/mcp-server-Pastea.log`. The bridge never logs\nthe token.\n\n## Development\n\n```bash\nnpm install\nnpm test            # node --test, no network\nnpm run build       # tsc → dist/\nscripts/pack.sh     # validate + pack → build/pastea-mcp-<version>.mcpb + SHA256SUMS\n```\n\nRun it against a development Pastea by hand:\n\n```bash\nPASTEA_MCP_URL=http://127.0.0.1:41418/mcp node dist/index.js\n```\n\nthen type JSON-RPC lines on stdin (`initialize`, `notifications/initialized`, `tools/list`).\nReleases are cut by tagging `v<version>` (matching `package.json`, `manifest.json`,\n`server.json` and `src/version.ts`); the workflow packs the bundle and publishes it.\n\n## Contributing\n\nIssues and pull requests welcome — see [the issue tracker](https://github.com/pastea-app/pastea-mcp/issues).\n\n## License\n\n[MIT](LICENSE) © [Nexo Labs](https://pastea.app)\n",
  "bytes": 7275,
  "sha": "9eb1ad9ac4f74c60e7c0b5172fcfd030dfbeb63cbde9e2efbc0826743996b267",
  "repo_slug": "pastea-app/pastea-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pastea_app_pastea_mcp_61d491f8/readme"
}