# screenpipe MCP server

> Search your local screen recordings, audio transcripts and computer activity captured by screenpipe.

- Listing: https://mcp.tc/i/screenpipe
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: no API key needed
- Category: [AI & Machine Learning](https://mcp.tc/c/ai-ml)
- Vendor: screenpipe
- Homepage: <https://screenpipe.com>
- Repository: <https://github.com/screenpipe/screenpipe/tree/HEAD/packages/screenpipe-mcp>
- Package: npm `screenpipe-mcp`

## About

Connects an AI assistant to screenpipe, an application that continuously captures your screen and audio and stores the history locally. Through the MCP server you can ask questions about what you saw, did or heard on your computer, such as what happened in the last five minutes or a summary of today's conversations.

Runs locally over stdio as the npm package screenpipe-mcp, started with npx. It needs the screenpipe app or CLI installed and recording on the same machine. No API key is listed. screenpipe is source-available under a commercial license, with personal non-commercial use permitted.

## What it can do

- Search local screen recordings with natural language
- Search audio transcripts from meetings and calls
- Review recent computer activity and app usage
- Summarize a day's conversations and work
- Give coding agents context about what you are working on

## Example prompts

- "What did I see on my screen in the last 5 minutes?"
- "Summarize my conversations from today."
- "Find the document I was reading in the browser this morning."
- "What did we discuss in my last meeting?"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

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

2. Start Claude Code and type `/mcp`. **screenpipe** should show as connected.

Add `--scope user` to make it available in every project.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

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

2. Save the file and restart Claude Desktop.

Needs Node.js on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=screenpipe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInNjcmVlbnBpcGUtbWNwIl19>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

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

Needs Node.js on your computer.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=screenpipe&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22screenpipe-mcp%22%5D%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"screenpipe","type":"stdio","command":"npx","args":["-y","screenpipe-mcp"]}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "screenpipe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "screenpipe-mcp"
      ]
    }
  }
}
```

Needs Node.js on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

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

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add screenpipe -- npx -y screenpipe-mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.screenpipe]
command = "npx"
args = ["-y", "screenpipe-mcp"]
```

Needs Node.js on your computer.

### Gemini CLI

```bash
gemini mcp add screenpipe npx -- -y screenpipe-mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

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

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs Node.js on your computer.

## Details

- Server version: 0.19.4
- Last checked: 2026-10-04
- Listed: 2026-10-04
- Updated: 2026-10-04

---
Source: https://mcp.tc/i/screenpipe (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report