MCP
Connect your agents to Ojito via MCP
Ojito ships a local, read-only MCP server over stdio. Claude Desktop, Claude Code, Cursor, and Codex can search what you read, watched, or captured on your Mac without uploading anything to the cloud.
1-click setup from Ojito
The fastest way to wire up your agents is straight from the app:
- Open Ojito on your Mac.
- Go to Onboarding or open Settings → Agents.
- Click Connect next to Claude Desktop, Claude Code, Cursor, or Codex.
Stable path across updates
Ojito registers the stable binary path /Applications/Ojito.app/Contents/MacOS/Ojito, so Sparkle updates never break your agent configuration.
Manual setup
If you prefer editing config files by hand or use another MCP client, copy the matching snippet below:
{
"mcpServers": {
"ojito": {
"command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
"args": ["--mcp"]
}
}
}claude mcp add ojito -- /Applications/Ojito.app/Contents/MacOS/Ojito --mcp{
"mcpServers": {
"ojito": {
"command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
"args": ["--mcp"]
}
}
}[mcp_servers.ojito]
command = "/Applications/Ojito.app/Contents/MacOS/Ojito"
args = ["--mcp"]{
"command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
"args": ["--mcp"]
}Available tools
The MCP server exposes 5 tools: 4 read-only tools over your local SQLite + FTS5 database, plus send_feedback, which opens Ojito's native feedback window prefilled with your draft so you can review it and click Send.
| Tool | What it does | Parameters |
|---|---|---|
search | Full-text search over everything saved in Ojito: screenshots (OCR text), X posts and threads, web pages, YouTube transcripts, and voice notes. Returns relevance-ranked matches with item ids. | query (string, required), source ("all" | "x" | "web" | "apps"), topic (string), limit (1-100, default 20) |
get_item | Returns the full saved content of a single item as Markdown: page or post text, transcript, or OCR text from the screenshot, along with its metadata. | id (integer, required; from search or recent) |
recent | Lists the most recently saved items, newest first. | source ("all" | "x" | "web" | "apps"), limit (1-100, default 20) |
list_topics | Lists the topics Ojito sorted your items into, most common first. | None |
send_feedback | Opens Ojito's native feedback window prefilled with your draft so you can review it and click Send. The MCP server itself stays strictly read-only and never sends network requests on its own. | message (string, required), kind ("feedback" | "bug" | "idea") |
Privacy guarantee
Private captures are never exposed over MCP
Private and hidden captures never leave your Mac and are filtered out of search, recent, list_topics, and get_item. The MCP server itself is strictly read-only, runs over local stdio with no network port, and never sends network requests on its own. When an agent calls send_feedback, it only opens Ojito's native feedback window prefilled with your draft so you can review it and click Send.
5 real prompts to try
Once Ojito is connected, try any of these prompts in Claude, Cursor, or Codex:
Recall a thread or article you read this week
"Search Ojito for the thread or article I read this week about SQLite FTS5 and give me the key takeaways with the source link."
Pull a code snippet from a captured page
"Use Ojito to find the docs page where I saw the Sparkle update setup example and pull out the full code snippet."
Summarize your research on a topic
"Check my Ojito topics, search everything I saved on local-first architecture, and summarize the recurring patterns."
Find a YouTube video you watched
"Search Ojito for the YouTube video I watched about incremental Swift builds and find the part explaining build caching."
Review recent captures before writing a doc
"Look at my 15 most recent Ojito captures and organize them into a reference outline for the technical doc I am about to write."
Next step
Download or update Ojito
Install Ojito 0.2.4 on macOS to connect your agents in seconds, or explore daily workflows and recent releases.