screenpipe MCP server - connect to Claude, Cursor & AI assistants

screenpipe provides an MCP (Model Context Protocol) server that lets AI assistants like Claude and Cursor search your screen recordings, audio transcriptions, and control your computer.

claude desktop

open the screenpipe app → settings → connections → click “install extension” Claude will open and prompt you to confirm. click install — done! try asking Claude: “what did I do in the last 5 minutes?”

make sure screenpipe is running when you use Claude with screenpipe features.

claude code

one command:

claude mcp add screenpipe --transport stdio -- npx -y screenpipe-mcp

to make it available across all your projects:

claude mcp add screenpipe --transport stdio --scope user -- npx -y screenpipe-mcp

verify with claude mcp list or /mcp inside Claude Code.

cursor

click here to install in cursor or manually: open cursor settings → mcp → add new global mcp server → set command to npx with args ["-y", "screenpipe-mcp"].

other editors (cline, continue, windsurf, etc.)

any editor that supports MCP works with screenpipe. the server command is:

npx -y screenpipe-mcp

add this as a stdio MCP server in your editor’s MCP settings. see also:

available tools

search-content (all platforms)

search through recorded screen content, audio transcriptions, and user input events:

parameter	type	description
`q`	string	search query (optional - omit to get recent content)
`content_type`	string	`all`, `ocr`, `audio`, `input`, or `accessibility` (default: `all`)
`limit`	integer	max results (default: 10)
`offset`	integer	pagination offset (default: 0)
`start_time`	string	ISO 8601 UTC start time (e.g., `2024-01-15T10:00:00Z`)
`end_time`	string	ISO 8601 UTC end time
`app_name`	string	filter by app (e.g., `Google Chrome`, `Slack`)
`window_name`	string	filter by window title
`min_length`	integer	minimum content length
`max_length`	integer	maximum content length
`include_frames`	boolean	include base64 screenshots (OCR only)
`speaker_ids`	string	comma-separated speaker IDs for audio filtering (e.g., `1,2,3`)
`speaker_name`	string	filter audio by speaker name (case-insensitive partial match)

export-video

create video exports from screen recordings for a specific time range:

parameter	type	description
`start_time`	string	ISO 8601 UTC start time (required)
`end_time`	string	ISO 8601 UTC end time (required)
`fps`	number	frames per second (default: 1.0)

example queries

try these in Claude or Cursor:

“search for any mentions of ‘project’ in my screen recordings”
“find audio transcriptions from the last hour”
“show me what was on my screen in VS Code yesterday”
“export a video of my screen from 10am to 11am today”
“find what John said in our meeting about the API”
“what did I type in Slack today?” (uses content_type=input)
“what did I copy to my clipboard recently?” (uses content_type=input)

testing

test your setup with MCP Inspector:

npx @modelcontextprotocol/inspector npx screenpipe-mcp

requirements

screenpipe must be running on localhost:3030
Node.js >= 18.0.0

manual config (advanced)

Show manual JSON configuration

if the one-click methods above don’t work, you can manually edit config files.claude desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %AppData%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "screenpipe": {
      "command": "npx",
      "args": ["-y", "screenpipe-mcp"]
    }
  }
}

cursor — create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "screenpipe": {
      "command": "npx",
      "args": ["-y", "screenpipe-mcp"]
    }
  }
}

from source:

git clone https://github.com/screenpipe/screenpipe
cd screenpipe/crates/screenpipe-integrations/screenpipe-mcp
npm install && npm run build

then point your editor to node /path/to/screenpipe-mcp/dist/index.js.

troubleshooting

mcp not connecting?

ensure screenpipe is running (screenpipe in terminal)
check it’s accessible at http://localhost:3030/health
restart Claude Desktop / Cursor after config changes

macos automation not working?

grant accessibility permissions in System Settings > Privacy & Security > Accessibility

still stuck? ask in our discord — the community can help debug MCP issues.

get started

use cases

guides

integrations

reference

compare

resources

screenpipe MCP server - connect to Claude, Cursor & AI assistants

claude desktop

claude code

cursor

other editors (cline, continue, windsurf, etc.)

available tools

search-content (all platforms)

export-video

example queries

testing

requirements

manual config (advanced)

troubleshooting

get started

use cases

guides

integrations

reference

compare

resources

​claude desktop

​claude code

​cursor

​other editors (cline, continue, windsurf, etc.)

​available tools

​search-content (all platforms)

​export-video

​example queries

​testing

​requirements

​manual config (advanced)

​troubleshooting

claude desktop

claude code

cursor

other editors (cline, continue, windsurf, etc.)

available tools

search-content (all platforms)

export-video

example queries

testing

requirements

manual config (advanced)

troubleshooting