Clipboard documentation

Connect your agents to one persistent clipboard, then save and retrieve exact text from any session.

Overview

Clipboard is a remote MCP server that lets your agent save and retrieve text across tools, sessions, and projects. Nothing needs to keep running on your computer. Connect once with OAuth and use Clipboard from the conversation you are already in.

01Connect an agent

Add the remote MCP server and authorize it.

02Save useful text

Ask the agent to keep research, prompts, or instructions.

03Retrieve it anywhere

Search from another client and get the exact text.

MCP endpoint

https://mcp.clipboard.work/mcp

Quickstart

Clipboard takes a few minutes to connect. You only need an account and a client that supports remote MCP servers.

Create a Clipboard account.
Add the remote MCP server to your client.
Complete the browser sign-in and authorization flow.
Open a new chat and ask the agent to save something to Clipboard.

Test the connection

Ask: “Save hello, world to Clipboard, then list my clipboard.”

Connect to Codex

Add Clipboard from a terminal:

codex mcp add clipboard --url https://mcp.clipboard.work/mcp

Then start OAuth sign-in:

codex mcp login clipboard

Clipboard should appear as connected in a new Codex session.

Connect to Claude Code

Add the remote HTTP server for your user account:

claude mcp add --transport http clipboard https://mcp.clipboard.work/mcp --scope user

Run /mcp in Claude Code, select Clipboard, and complete the browser authorization flow.

Connect to OpenCode

Run the interactive setup and choose a remote MCP server:

opencode mcp add

Use clipboard as the name and https://mcp.clipboard.work/mcp as the URL. You can also add it directly to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "clipboard": {
      "type": "remote",
      "url": "https://mcp.clipboard.work/mcp",
      "enabled": true
    }
  }
}

Authenticate with:

opencode mcp auth clipboard

Using Clipboard

You normally do not need to name a tool. Tell the agent what should be kept or retrieved in natural language.

“Save this research to Clipboard so I can continue it later.”

“Find the prompt I used to generate the logo and paste it here.”

“Get my standard CLAUDE.md for Kaggle competitions and set it up in this project.”

Descriptions

Descriptions make retrieval work. When saving text, the agent should write a factual description of roughly 200 to 350 characters.

A useful description says what the text contains, why it may be useful, and includes distinctive terms another agent might search later. Clipboard searches titles and descriptions first, then retrieves the exact text only when needed.

Good description

Reusable CLAUDE.md for Kaggle competitions covering notebook structure, validation discipline, submission checks, and rules for preserving experiment history.

Tools

Clipboard exposes six small tools. Agents usually choose them without your help.

dump

Save text with a concise title and retrieval description.

get

Retrieve the complete stored text by item ID.

search

Find candidates by title and description.

list

Browse item metadata newest first.

update

Replace an item's text and optionally its title or description.

delete

Permanently remove an item.

Titles can contain up to 120 characters, descriptions up to 500 characters, and stored text up to 100,000 Unicode characters.

Troubleshooting

The server is connected but no tools appear

Start a new agent session. MCP tool lists are commonly loaded when a session begins.

OAuth did not finish

Retry the client's login or authorization command. For OpenCode, run opencode mcp debug clipboard to inspect discovery and authentication.

The wrong item was retrieved

Ask the agent to search first and compare titles and descriptions. Then call get only for the selected item.

Still stuck? Email hello@clipboard.work.