Screenpipe MCP Server

https://github.com/user-attachments/assets/7466a689-7703-4f0b-b3e1-b1cb9ed70cff

MCP server for screenpipe - search your screen recordings, audio transcriptions, and control your computer with AI.

Installation

Option 1: NPX (Recommended)

The easiest way to use screenpipe-mcp is with npx. Edit your Claude Desktop config:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %AppData%\Claude\claude_desktop_config.json

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

Option 2: From Source

Clone and build from source:

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

Then configure Claude Desktop:

{
  "mcpServers": {
    "screenpipe": {
      "command": "node",
      "args": ["/absolute/path/to/screenpipe-mcp/dist/index.js"]
    }
  }
}

Note: Restart Claude Desktop after making changes.

Testing

Test with MCP Inspector:

npx @modelcontextprotocol/inspector npx screenpipe-mcp

Available Tools

Cross-Platform

• search-content - Search through recorded screen content, audio transcriptions, and UI elements

  • Full text search with content type filtering (OCR/Audio/UI)
  • Time range and app/window filtering
  • Pagination support

• pixel-control - Control mouse and keyboard

  • Type text, press keys, move mouse, click

macOS Only

• find-elements - Find UI elements in applications by role
• click-element - Click UI elements by accessibility ID
• fill-element - Type text into UI elements
• scroll-element - Scroll UI elements
• open-application - Open applications by name
• open-url - Open URLs in default browser

Example Queries in Claude

• "Search for any mentions of 'rust' in my screen recordings"
• "Find audio transcriptions from the last hour"
• "Show me what was on my screen in VSCode yesterday"
• "Open Safari and go to github.com"
• "Find the search button in Chrome and click it"

Requirements

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

Notes

• All timestamps are handled in UTC
• Results are formatted for readability in Claude's interface
• macOS automation features require accessibility permissions