install screenpipe

desktop app (recommended)

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

bunx screenpipe record

Show linux: additional dependencies

# ubuntu/debian
sudo apt install libpulse0 libasound2-dev ffmpeg

# fedora
sudo dnf install pulseaudio-libs alsa-lib ffmpeg

# arch
sudo pacman -S libpulse alsa-lib ffmpeg

verify it’s running

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

# 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
CLI reference — all commands and options

get started

use cases

guides

integrations

reference

compare

resources

desktop app (recommended)

CLI

verify it’s running

connect to AI

what’s next?

get started

use cases

guides

integrations

reference

compare

resources

​desktop app (recommended)

​CLI

​verify it’s running

​connect to AI

​what’s next?

desktop app (recommended)

CLI

verify it’s running

connect to AI

what’s next?