Screenpipe MCP Server

Lets an assistant search your recorded screen, audio transcripts and computer activity captured by screenpipe.

Official · screenpipe TypeScript Local · stdio Knowledge and memoryProductivity

81 popularity score ★ 22k ↓ 8.5k/wk

Connect your client

Local (npm)

Add in one click

Opens the app, which asks before it adds the server.

Or add it by command or config

Claude CodeTerminal
claude mcp add screenpipe -- npx -y screenpipe-mcp
Claude Desktopclaude_desktop_config.json
{
  "mcpServers": {
    "screenpipe": {
      "command": "npx",
      "args": [
        "-y",
        "screenpipe-mcp"
      ]
    }
  }
}
Cursor~/.cursor/mcp.json
{
  "mcpServers": {
    "screenpipe": {
      "command": "npx",
      "args": [
        "-y",
        "screenpipe-mcp"
      ]
    }
  }
}
VS Code.vscode/mcp.json
{
  "servers": {
    "screenpipe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "screenpipe-mcp"
      ]
    }
  }
}
Codex~/.codex/config.toml
[mcp_servers.screenpipe]
command = "npx"
args = ["-y", "screenpipe-mcp"]
Gemini CLITerminal
gemini mcp add --scope user screenpipe npx -- -y screenpipe-mcp

Settings 4

SCREENPIPE_LOCAL_API_KEY Optional: Local screenpipe API key (get it with screenpipe auth token); if omitted the server tries to discover it.
SCREENPIPE_ENTERPRISE_TOKEN Optional: Enterprise admin token that enables the team-* tools.
SCREENPIPE_TEAM_API_URL Optional: Query gateway URL for organisations running their own.
SCREENPIPE_MCP_SENTRY_DISABLED Optional: Set to 1 to turn off crash and error reports.

What it does

Screenpipe is a desktop app that continuously records your screen and audio on your own computer, extracting screen text, accessibility data, transcripts and input events into a local database. Its MCP server lets an assistant search that history: find text that was on screen or said in a meeting, summarise what you worked on in a time range, look at the UI elements of a captured frame, and export a video of a period.

It also manages meetings and their speaker-attributed transcripts, names and merges speakers, tags frames, keeps persistent memories, starts and stops audio recording, sends notifications to the desktop app and manages pipes, which are scheduled automations driven by a prompt. Enterprise admins get extra team tools that search an organisation's recorded data.

The screenpipe app must be running on localhost:3030. The recommended setup is the screenpipe desktop app, which configures Claude Desktop with its local API key; otherwise run npx -y screenpipe-mcp@latest with SCREENPIPE_LOCAL_API_KEY (from screenpipe auth token), on Node.js 18 or newer. An HTTP mode (screenpipe-mcp --http) serves remote clients. The server is source-available under the Screenpipe Commercial License.

Tools 31

search-content
Search recorded content (screen OCR text, audio transcripts, input events, accessibility text, parsed app data) with time range, app, window and speaker filters.
keyword-search
Fast full-text keyword search across screen text and audio.
activity-summary
Compressed activity overview for a time range: active minutes per app, windows, edited documents and recent context.
export-video
Export screen recordings for a time range as a video file.
search-elements
Search structured UI elements (accessibility tree nodes and OCR text blocks) by source, role, app and time.
get-frame-elements
The element tree of one captured frame.
frame-context
Accessibility text, parsed nodes and extracted URLs for one frame.
list-meetings
List detected meetings, optionally filtered by title, attendees or notes.
get-meeting
Get a meeting's note, attendees and times, optionally with the speaker-attributed transcript.
update-meeting
Update fields of a meeting.
start-meeting
Start a manual meeting recording session.
stop-meeting
Stop a manual meeting recording session.
search-speakers
Search speakers by name prefix.
list-unnamed-speakers
List speakers that have not been named.
update-speaker
Rename a speaker.
merge-speakers
Merge two speakers detected as different people.
add-tags
Tag a screen frame or audio chunk for later retrieval.
update-memory
Create, update or delete a persistent memory (facts, preferences, decisions).
send-notification
Send a notification to the screenpipe desktop app.
control-recording
Start or stop audio recording.
health-check
Check whether screenpipe is running, with recording status and stats.
list-audio-devices
List audio input and output devices.
list-monitors
List monitors available for capture.
list-pipes
List pipes (scheduled automations) with state and schedule.
create-pipe
Create a pipe that runs a markdown prompt on a schedule.
run-pipe
Trigger a one-off run of a pipe.
pipe-logs
Fetch recent output of a pipe.
team-search
Enterprise: search across an organisation's recorded data (needs an admin token).
team-devices
Enterprise: list enrolled devices.
team-records
Enterprise: chronological frame, app or audio records for a time window.
team-frame
Enterprise: one PII-redacted frame image.

Similar servers