Blog

Use Mac Clipboard History as Context for Claude, Cursor, and Codex via MCP

You copy an error from Terminal. Then a stack overflow snippet. Then a screenshot of a failing UI. Ten minutes later you are in Claude, Cursor, or Codex, pasting those pieces into chat by hand — or worse, you already overwrote the one clip you needed.

That busywork is the gap. Your Mac already kept a clipboard history. Your AI agent just could not see it.

Paste It! ships a built-in MCP bridge so Claude, Cursor, Codex, and other MCP-capable agents can read your local clipboard history — including text OCR extracted from screenshots — without you acting as the copy-paste cable.

Disclosure: we make Paste It!, a free and open-source Mac clipboard manager. This walkthrough is for our MCP. Where a lighter “current clipboard only” server is enough, we say so.

Updated July 2026.

What MCP gives you here (and what it does not)

Model Context Protocol (MCP) is how AI apps talk to local tools. A lot of “clipboard MCP” servers only expose the current pasteboard: read what is on the clipboard right now, maybe write text back.

Paste It! is different: the agent can browse and search your clipboard history on this Mac — the same history you open with Shift + Command + V — including OCR-indexed screenshot text.

It is read-only on purpose:

  • Agents can list recent clips and search history (OCR included).
  • Agents cannot insert clips into history, clear history, or otherwise rewrite your clipboard library.

Read-only local history for your AI: it can look up what you copied, but it cannot wipe or invent your pastes.

Connect Paste It! to Claude, Cursor, or Codex

  1. Install and run Paste It! so clipboard history is capturing on your Mac.
  2. Open MCP from the menu bar (Paste It! menu).
  3. Copy the MCP URL the app shows you.
  4. Paste that URL into your agent’s MCP / connector setup — Claude Desktop, Cursor, Codex, or any client that accepts an MCP server URL.
  5. Ask the agent something that needs clipboard context (examples below). Approve access if the client prompts you.

You do not need a separate npm clipboard daemon for history search. The bridge is built into the app; your data stays on the Mac.

For the feature summary and release notes, see Features → MCP and the changelog.

Prompts that actually use history

Once connected, try:

  • “Search my clipboard history for the AWS error I copied earlier today.”
  • “What URLs did I copy in the last hour?”
  • “Find the screenshot where the checkout button was broken — use OCR text if needed.”
  • “Summarize the last few code snippets I copied from Cursor.”

The useful pattern is: stop pasting context into the chat. Point the agent at history and let it pull the clip.

Privacy and trust

Paste It! is local-first: clipboard contents are not uploaded to Paste It! servers for sync or analytics. MCP is a local bridge to the AI apps you connect.

That still means: anything the agent can read may enter that AI product’s context window under their policies. Prefer pausing capture or ignoring password managers for sensitive apps, and only connect clients you trust. Because the MCP is read-only, a runaway agent still cannot empty or poison your history through these tools.

How this compares (honestly)

ApproachWhat the agent seesCost / setup
Paste It! MCPLocal history + OCR search; read-onlyFree, open source; menu-bar URL
Paid clipboard apps with MCP (e.g. Paste)Often history + richer boards; product variesSubscription / paid ecosystem
Lightweight clipboard MCP serversUsually current clipboard read/write onlySeparate install; no full Paste It! UI

If you only need “fix what is on my clipboard right now,” a tiny current-clipboard MCP may be enough. If you want history search — including text inside screenshots — you want a history MCP, not just pbcopy/pbpaste wrapped as a tool.

FAQ

Does this work with Claude, Cursor, and Codex only?

Any MCP client that can take the server URL from Paste It!’s menu bar can connect. We call out Claude, Cursor, and Codex because those are the agents people ask about most.

Can the agent clear or edit my clipboard history?

No. Browse and search (including OCR) are allowed. Insert, clear, and other writes are not.

Is this the same as an “AI clipboard manager” with semantic search?

No. This is tool access for agents via MCP, not on-device semantic embeddings or AI rewrite buttons inside the clipboard UI. Different problem, different search results.


Ready to stop pasting context by hand? Download Paste It! for Mac, open MCP from the menu bar, and point Claude, Cursor, or Codex at your local history. More on the product side: MCP on Features.