> ## Documentation Index
> Fetch the complete documentation index at: https://docs.screenpipe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# give AI memory of your screen

> Give Claude, Cursor, Ollama, and other LLMs persistent memory of everything on your screen so they can answer questions with full context.

screenpipe acts as a memory layer for AI — it gives LLMs context about what you've been doing on your computer.

## why AI needs memory

LLMs are stateless — they don't know what you were working on 5 minutes ago. screenpipe bridges this by:

* capturing everything on your screen 24/7
* extracting app text primarily via accessibility APIs, with OCR fallback for visual-only surfaces
* making it searchable via REST API on `localhost:3030`

## connect to AI

### MCP (recommended)

screenpipe has a built-in MCP server that works with Claude Desktop, Cursor, and other MCP-compatible tools:

```json theme={null}
{
  "mcpServers": {
    "screenpipe": {
      "command": "npx",
      "args": ["-y", "screenpipe-mcp"]
    }
  }
}
```

<Tip>or run `npx -y screenpipe@latest agent setup <target>` (`claude-desktop`, `cursor`, `claude-code`, `codex`, `openclaw`, `hermes`, `windsurf`) to install the screenpipe skills and register the MCP server in one command.</Tip>

see [MCP server setup](/mcp-server) for details.

### pipes (scheduled agents)

[pipes](/pipes) are AI agents that run on a schedule and act on your screen data automatically — like syncing to Obsidian, tracking time in Toggl, or sending daily summaries. spin one up from the CLI — `npx -y screenpipe@latest pipe install <url-or-path> && npx -y screenpipe@latest pipe enable <name>` (`bunx` / `bun x` work too) — or ask any connected agent to build one for you.

### direct API

any tool that can make HTTP requests can query screenpipe:

```bash theme={null}
# get recent screen activity
curl "http://localhost:3030/search?content_type=all&limit=20"

# search for specific content
curl "http://localhost:3030/search?q=meeting+notes&app_name=Slack&limit=10"
```

<Note>the local API needs no auth by default. if you've enabled API auth in settings, add `-H "Authorization: Bearer <your-api-key>"` to these requests.</Note>

## use cases

| use case                     | how                        |
| ---------------------------- | -------------------------- |
| "what was I working on?"     | search by time range       |
| "summarize today's meetings" | query audio transcriptions |
| "find that code snippet"     | search screen text         |
| "auto-track my time"         | toggl-sync pipe            |
| "sync activity to notes"     | obsidian-sync pipe         |

## privacy-first

* all data stays on your device
* use local LLMs (Ollama, LMStudio) for complete privacy
* filter what gets captured in **settings → privacy** — ignore or include specific apps, windows, and URLs ([privacy filters](/privacy-filter))
* no data sent to cloud unless you explicitly choose cloud providers

## next steps

* [build a second brain](/second-brain) — let your agent watch your activity and remember your workflows in the background
* [set up MCP server](/mcp-server) — connect to Claude, Cursor
* [set up pipes](/pipes) — scheduled AI agents
* [API reference](/cli-reference) — REST API search parameters and endpoints
* [join our discord](https://discord.gg/screenpipe) — get help from the community

## get screenpipe

screenpipe gives your AI assistants memory of everything on your screen.

[download screenpipe →](https://screenpi.pe/onboarding)