MCP server setup for Claude, Cursor, and other AI tools

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

quick setup (recommended)

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.

manual setup (stdio)

if the one-click install doesn’t appear or you prefer manual config, edit Claude’s config file directly: macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows: %AppData%\Claude\claude_desktop_config.json add or update the mcpServers section:

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

save, then restart Claude Desktop completely (force-quit from Activity Monitor / Task Manager, then reopen). verify the connection works by asking Claude: “what’s on my screen right now?“

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"].

warp

Warp’s Agent Mode supports MCP. Open Settings → AI → Manage MCP servers → + Add, choose CLI Server (Command), then paste:

{
  "screenpipe": {
    "command": "npx",
    "args": ["-y", "screenpipe-mcp@latest"],
    "start_on_launch": true
  }
}

Save — the server should show Running. Then ask Warp’s agent: “what did I do in the last 5 minutes?”

Warp’s MCP schema is per-server (no wrapping mcpServers object). Don’t paste the Claude/Cursor JSON shape — it won’t validate.

You can also reach this screen via the Command Palette → Open MCP Servers. Or just open the screenpipe app → settings → connections → Warp to copy the config.

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:

HTTP transport (optional)

if you need remote MCP access or prefer HTTP over stdio, the screenpipe-mcp package also provides an HTTP server:

npx -y screenpipe-mcp-http --port 3031

this is useful for tools like Msty that support HTTP MCP transport. both screenpipe-mcp (stdio) and screenpipe-mcp-http (HTTP) come from the same npm package screenpipe-mcp.

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/packages/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

pipes

connect

use cases

integrations

reference

compare

resources

MCP server setup for Claude, Cursor, and other AI tools

claude desktop

quick setup (recommended)

manual setup (stdio)

claude code

cursor

warp

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

HTTP transport (optional)

available tools

search-content (all platforms)

export-video

example queries

testing

requirements

manual config (advanced)

troubleshooting

get started

pipes

connect

use cases

integrations

reference

compare

resources

Documentation Index

​claude desktop

​quick setup (recommended)

​manual setup (stdio)

​claude code

​cursor

​warp

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

​HTTP transport (optional)

​available tools

​search-content (all platforms)

​export-video

​example queries

​testing

​requirements

​manual config (advanced)

​troubleshooting

claude desktop

quick setup (recommended)

manual setup (stdio)

claude code

cursor

warp

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

HTTP transport (optional)

available tools

search-content (all platforms)

export-video

example queries

testing

requirements

manual config (advanced)

troubleshooting