# Clipboard History Searcher MCP for AI Agents AI Agent Connect

> Clipboard History Searcher lets you search through your exported clipboard history from apps like Ditto, CopyQ, or Maccy using your AI client. Instead of scrolling through thousands of old clips to find that one URL or phone number, you can just ask your agent to find it for you. It handles JSON and plain text exports to make your past copies instantly searchable.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_DMMaILLFq773X6a6GyTPbXNQUISwvzxx1QMXczD9/ai-agent-connect
- **Tags:** clipboard-manager, search-utility, data-retrieval, productivity-tool, local-storage

## Description

Clipboard History Searcher lets you turn your past clipboard logs into a searchable database that your AI client can actually read. You've all been there: you copied a specific snippet of code, a long URL, or a customer's phone number a few days ago, and now you can't find it. Most clipboard managers let you see the history, but digging through a massive list of hundreds of items is a chore. This Connector changes that by letting your AI client actually read those exported files. When you connect this to your workflow through Vinkius, you turn a messy pile of past copies into a searchable knowledge base. You just point your agent to the export file, and it can pull out exactly what you need in seconds. It supports the common formats used by Ditto, CopyQ, and Maccy, so you don't have to worry about manual conversions. It's built to be token-safe, meaning it won't overwhelm your agent's memory by trying to shove your entire history into one prompt. It just gives you the specific info you asked for.

## Tools

### search_clipboard_history
Parse a JSON or TXT clipboard history file to make your past copies searchable by your AI client. This lets you find specific data points without manual browsing.

## Prompt Examples

**Prompt:** 
```
Find the URL I copied yesterday that had 'github' in it.
```

**Response:** 
```
I found the following link in your clipboard history: **https://github.com/vinkius/awesome-project** (copied at entry #142).
```

**Prompt:** 
```
Search my clipboard for any phone numbers.
```

**Response:** 
```
I found 3 entries with phone numbers in your history:
- +1 555-0199
- +351 912 345 678
- (11) 99999-0000
```

**Prompt:** 
```
Show me all code snippets in my clipboard history.
```

**Response:** 
```
I found 8 entries that look like code snippets:
- **Python**: 3 entries
- **JavaScript**: 4 entries
- **SQL**: 1 entry
```

## Capabilities

### Search JSON exports from CopyQ or Maccy
The AI can read your exported JSON files to find specific data points.

### Parse plain text history from Ditto
This Connector reads your plain text clipboard logs to make them searchable.

### Filter past copies by content type
You can ask your agent to find only URLs or only phone numbers.

### Extract specific phone numbers
Your agent can pull out specific contact info from your history logs.

### Retrieve old code snippets
Find specific blocks of code you copied during past projects.

### Limit context to 200 clips
It keeps your AI's context window clean by only showing relevant results.

## Use Cases

### Finding a forgotten API key
A developer needs an API key they copied last month. Instead of digging through a clipboard app, they ask the agent to find it in their CopyQ export.

### Retrieving research URLs
A researcher needs a specific URL from a week ago. They ask the agent to find any GitHub links in their Maccy history from last Tuesday.

### Extracting contact numbers
A manager needs a phone number from a list. They ask the agent to find all entries with phone numbers in their Ditto history file.

### Locating old code blocks
A student wants a code snippet. They ask the agent to show all Python snippets they copied during a previous study session.

## Benefits

- No more manual scrolling through hundreds of clipboard entries to find a specific link or piece of text.
- Quickly grab old phone numbers or addresses from your history using natural language queries.
- Retrieve specific code snippets from past projects without hunting through multiple files.
- Save time by letting your AI client handle the heavy lifting of parsing JSON and TXT exports.
- Keep your AI's context window clean because this Connector only pulls in the relevant clips you need.
- Support for common tools like Ditto, CopyQ, and Maccy means you can use your existing clipboard setup.

## How It Works

The bottom line is you turn static clipboard logs into a searchable knowledge base for your AI.

1. Export your clipboard history from Ditto, CopyQ, or Maccy as a file.
2. Provide the file path to your AI client via this Connector.
3. Ask your agent to find specific data like URLs, numbers, or code.

## Frequently Asked Questions

**What clipboard managers work with the Clipboard History Searcher MCP?**
You can use it with Ditto, CopyQ, and Maccy. Just export your history from any of those apps as a JSON or plain text file.

**How does the Clipboard History Searcher MCP find old links?**
It parses your exported history file and lets your AI client search through it. You can ask for specific keywords, like 'GitHub' or 'login,' to find the exact URL you need.

**Is the Clipboard History Searcher MCP safe for my private data?**
Yes, it works with files you choose to export locally. The Connector doesn't upload your history to a cloud; it just lets your AI client read the file you provide.

**Can the Clipboard History Searcher MCP handle very large clipboard histories?**
It's designed to be token-safe. It handles the heavy lifting by showing your AI client up to 200 clips at a time, which prevents your agent from getting overwhelmed by huge files.

**Does the Clipboard History Searcher MCP work with plain text files?**
Yes, it supports both JSON exports from Maccy and CopyQ, as well as plain text exports from Ditto.

**How do I use the Clipboard History Searcher MCP to find phone numbers?**
Once you provide your export file, you can simply ask your AI client to 'find all phone numbers' or 'find the number for [Name].' It will scan the history and list them for you.

**Which clipboard managers are supported?**
Any manager that exports as JSON or plain text: Ditto (Windows), CopyQ (cross-platform), Maccy (macOS), Clipy (macOS).

**Does it capture images from clipboard?**
No, this parser focuses on textual clipboard entries to save AI context tokens.

**Is my clipboard data sent to the cloud?**
No. Parsed locally. Only text entries are sent to AI context during your session.