install screenpipe - Screenpipe

desktop app

download the desktop app and follow the installation instructions. works on macOS, Windows, and Linux.

the app manages recording, settings, and search — no terminal needed.

CLI

bash

npx screenpipe@latest record

this starts the screenpipe daemon in the background and continuously records your screen. data is stored in ~/.screenpipe/ on your local machine.

access your recorded timeline

after starting the CLI, you have three ways to access your screen history:

Desktop app (easiest) — download the screenpipe app for a visual timeline and built-in search
REST API — query recorded content directly via curl or code (see below)
AI assistants — connect Claude, Cursor, or other tools via MCP

verify it's running

once screenpipe starts, it serves an API on localhost:3030:

bash

# check health
curl http://localhost:3030/health

# search your screen history
curl "http://localhost:3030/search"

connect to AI

screenpipe works with any AI that supports MCP or HTTP APIs:

integration	how
claude desktop	add screenpipe as MCP server (guide)
cursor	add screenpipe MCP to your project (guide)
claude code	use screenpipe MCP or curl the API (guide)
ollama	configure in app settings, use any local model

what's next?

search your screen history — find anything you've seen
set up pipes — scheduled AI agents on your data
API reference — REST API endpoints and parameters
join our discord — get help from the community

get the desktop app

screenpipe includes everything you need out of the box — 24/7 screen recording, AI-powered search, pipes, MCP server, and more. lifetime plans available starting at $400.

download screenpipe →