CopySafe API Documentation — Clipboard Manager for Developers

CopySafe is a clipboard manager for iPhone and Mac with a built-in HTTP API for developers. The MCP (Model Context Protocol) Server runs locally on your Mac and lets AI assistants like Claude, ChatGPT, and custom automation tools access your full clipboard history, search across thousands of clips, and trigger 50+ developer actions — all through a simple REST API.

Who is this for? Developers who want to integrate clipboard data into their workflows. Use it with AI coding assistants to reference copied code snippets, URLs, and API keys. Build custom automations with any HTTP client. Connect CopySafe to Shortcuts, Raycast, Alfred, or any tool that can make HTTP requests.

Key capabilities: Read clipboard history with pagination and category filtering. Full-text search across all clips using FTS5. Run developer actions programmatically — JSON prettify, Base64 encode/decode, JWT inspect, URL encode, cURL to code, and 40+ more. All data stays local on your Mac, authenticated with Bearer tokens, protected by CORS validation.

Pricing: The MCP API is a CopySafe Pro feature ($4.99/mo, $34.99/yr, or $49.99 lifetime). All other CopySafe features — clipboard history, content detection, encrypted sync, keyboard extension — are free forever.

API Overview

The MCP Server runs locally on your Mac and exposes a REST API on localhost:19280-19380. It enables AI assistants like Claude, ChatGPT, and custom tools to read your clipboard history, search clips, and trigger actions. No internet connection required — everything stays on your local machine.

Authentication

All requests require a Bearer token. Find your token in CopySafe Settings → MCP.

curl -H "Authorization: Bearer YOUR_TOKEN" \
     http://localhost:19280/api/clips

Endpoints

GET/api/clips

Returns recent clipboard entries. Supports pagination and filtering.

Parameters

limit	Number of clips (default: 20, max: 100)
offset	Pagination offset
category	Filter by type: url, phone, email, code, etc.
search	Full-text search query (FTS5)

Response

{
  "clips": [
    {
      "id": "a1b2c3d4",
      "content": "https://github.com/...",
      "category": "url",
      "createdAt": "2026-04-02T10:30:00Z",
      "isPinned": false,
      "sourceApp": "com.apple.Safari"
    }
  ],
  "total": 2219,
  "hasMore": true
}

GET/api/clips/:id

Returns full clip details including content, OCR text, file metadata, and available actions.

POST/api/clips/search

Advanced search with multiple filters.

{
  "query": "API key",
  "categories": ["sensitive", "code"],
  "dateFrom": "2026-04-01",
  "limit": 10
}

POST/api/actions/transform

Run a dev action on text content. Returns transformed result.

{
  "action": "json-prettify",
  "input": "{\"a\":1,\"b\":2}"
}

// Response:
{
  "result": "{\n  \"a\": 1,\n  \"b\": 2\n}"
}

API Frequently Asked Questions

What is the CopySafe MCP API?

CopySafe MCP API is a local HTTP server that runs on your Mac and provides REST access to your clipboard history. MCP stands for Model Context Protocol — a standard for connecting AI tools to local data sources. It allows Claude, ChatGPT, and other AI assistants to read your clips, search them, and run developer actions like JSON prettify or Base64 decode.

Is clipboard data sent to any cloud server?

No. The MCP Server runs exclusively on localhost. Your clipboard data never leaves your Mac. Authentication is handled via Bearer tokens, and CORS validation ensures only authorized clients can connect. There are no external network calls.

Which AI tools work with CopySafe API?

Any tool that can make HTTP requests works with CopySafe API. This includes Claude (via MCP), ChatGPT (via custom actions), Raycast, Alfred, Apple Shortcuts, Python scripts, Node.js apps, cURL, and any automation platform. The API uses standard REST with JSON responses.

How much does the CopySafe API cost?

The MCP API is included in CopySafe Pro: $4.99/month, $34.99/year (save 42%), or $49.99 lifetime (pay once, use forever). All plans include a 21-day free trial. CopySafe core features — clipboard history, content detection, encrypted sync, keyboard extension — are free forever.

Pro Feature

MCP Server is available with CopySafe Pro ($4.99/mo or $34.99/yr). CORS validation ensures only authorized clients connect. All data stays local.

CAPTURE

ORGANIZE

PLATFORMS