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:

  1. Open Ojito on your Mac.
  2. Go to Onboarding or open Settings → Agents.
  3. 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:

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json
JSON
{
  "mcpServers": {
    "ojito": {
      "command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
      "args": ["--mcp"]
    }
  }
}

Claude Code

Terminal command
Shell
claude mcp add ojito -- /Applications/Ojito.app/Contents/MacOS/Ojito --mcp

Cursor

~/.cursor/mcp.json
JSON
{
  "mcpServers": {
    "ojito": {
      "command": "/Applications/Ojito.app/Contents/MacOS/Ojito",
      "args": ["--mcp"]
    }
  }
}

Codex

~/.codex/config.toml
TOML
[mcp_servers.ojito]
command = "/Applications/Ojito.app/Contents/MacOS/Ojito"
args = ["--mcp"]

Any MCP client (stdio)

Standard stdio transport
JSON
{
  "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.

ToolWhat it doesParameters
searchFull-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_itemReturns 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)
recentLists the most recently saved items, newest first.source ("all" | "x" | "web" | "apps"), limit (1-100, default 20)
list_topicsLists the topics Ojito sorted your items into, most common first.None
send_feedbackOpens 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:

01

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."

02

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."

03

Summarize your research on a topic

"Check my Ojito topics, search everything I saved on local-first architecture, and summarize the recurring patterns."

04

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."

05

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.