Clipboard Tools v1.0.0

Clipboard & system clipboard-tools 4 actions MCP

Read, write, append to, and transform the system clipboard's text: get the current contents, set or append new text, or apply a quick transform (case, whitespace, line sort/dedupe).

Open in Omniscient Back to apps

The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.

Actions

Jump to: getsetappendtransform

Get clipboard text

get

Read the current clipboard text without changing it.

Inputs

This action takes no inputs.

Outputs

Name	Type	Notes
`text`	text

Set clipboard text

set Destructive

Replace the clipboard contents with the given text.

Inputs

Name	Type	Required / default	Values and notes
`text`	text	required

Outputs

Name	Type	Notes
`text`	text

Append to clipboard

append Destructive

Join text onto whatever is already on the clipboard - before or after it - and write the combined result back.

Inputs

Name	Type	Required / default	Values and notes
`text`	text	required
`position`	enum	optional, default `after`	`afterbefore`
`separator`	string	optional, default

Outputs

Name	Type	Notes
`text`	text
`previous`	text

Transform clipboard text

transform Destructive

Apply a text transform to the current clipboard content and write the result back: upper/lower case, whole-text strip, per-line trim, dedupe lines, or sort lines.

Inputs

Name	Type	Required / default	Values and notes
`op`	enum	required	`upperlowerstriptrimdedupe_linessort_lines`

Outputs

Name	Type	Notes
`text`	text
`previous`	text

Use it

Get clipboard text

Command line

shell

python app.py --action get --params '{}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clipboard-tools", "get", {})

Workflow node

json

{
  "id": "n0",
  "app": "clipboard-tools",
  "action": "get",
  "params": {},
  "inputs": {}
}

Set clipboard text

Command line

shell

python app.py --action set --params '{"text": "<text>"}'

# preview first - destructive action, nothing is changed:
python app.py --action set --params '{"text": "<text>"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clipboard-tools", "set", {"text": "<text>"})

# preview first:
run_action("clipboard-tools", "set", {"text": "<text>"}, dry_run=true)

Workflow node

json

{
  "id": "n0",
  "app": "clipboard-tools",
  "action": "set",
  "params": {
    "text": "<text>"
  },
  "inputs": {}
}

Append to clipboard

Command line

shell

python app.py --action append --params '{"text": "<text>"}'

# preview first - destructive action, nothing is changed:
python app.py --action append --params '{"text": "<text>"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clipboard-tools", "append", {"text": "<text>"})

# preview first:
run_action("clipboard-tools", "append", {"text": "<text>"}, dry_run=true)

Workflow node

json

{
  "id": "n0",
  "app": "clipboard-tools",
  "action": "append",
  "params": {
    "text": "<text>"
  },
  "inputs": {}
}

Transform clipboard text

Command line

shell

python app.py --action transform --params '{"op": "upper"}'

# preview first - destructive action, nothing is changed:
python app.py --action transform --params '{"op": "upper"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clipboard-tools", "transform", {"op": "upper"})

# preview first:
run_action("clipboard-tools", "transform", {"op": "upper"}, dry_run=true)

Workflow node

json

{
  "id": "n0",
  "app": "clipboard-tools",
  "action": "transform",
  "params": {
    "op": "upper"
  },
  "inputs": {}
}

Example prompts

Things you can say to Claude, Cursor or Codex once the MCP server is registered.

what's on my clipboard right now?
put 'hello world' on the clipboard
append '- reviewed' to whatever is on my clipboard
uppercase the text currently on my clipboard
sort the lines on my clipboard and remove duplicates