screenpipe-mcp
io.github.screenpipe/screenpipe-mcp · version 0.20.4 · 4,770 weekly npm downloads · audited 2026-11-03
Notes
Findings
No hidden-instruction or invisible-character findings in any tool, prompt, or resource description.
Claude Connectors Directory readiness
- ❌ Every tool has a title Missing on 4 of 34: search-chats, list-workflows, get-workflow, screenpipe-skills
- ✅ Every tool declares readOnlyHint or destructiveHint 34 of 34 tools
- ✅ Tool names are 64 characters or fewer All within limit
- ❌ Descriptions avoid instructions about model behavior or other tools 14 of 34 descriptions reference other tools or tell the model what it must do: get-workflow, search-content, search-synced-content, list-meetings and 10 more
- ✅ No hidden instructions or invisible characters in tool metadata None found
Checks the directory's published tool requirements that are visible from tools/list. Passing them does not guarantee acceptance.
Supply chain
- Install scripts: none
- npm provenance: no
- Source repository linked: no
- License: SEE LICENSE IN LICENSE.md
- Direct dependencies: 0
Tools (34)
| Name | Title | Hint | Description |
|---|---|---|---|
search-chats | read-only | Search existing local Screenpipe, Codex, Claude Code, Cursor, and Gemini CLI conversations by transcript text, title, preview, workspace, or exact ID. Omit query for recent chats. Returns bounded previews and source attr… | |
list-workflows | read-only | Find the user's saved workflows from Screenpipe: repeated work, triggers, outcomes, and evidence status. Use before planning to automate their work. Reads the same catalog as the desktop Workflows view; does not run anal… | |
get-workflow | read-only | Read a workflow's ordered steps, source quotes, decisions, missing details, and historical accessibility evidence (roles, text, bounds, automation properties and URLs when captured). IDs come from list-workflows. Frame m… | |
screenpipe-skills | read-only | List Screenpipe's bundled workflow skills, or read one by exact name before using it. Covers recall, meetings, project handoffs, decisions, customer context, bug reports, and process guides. Available without filesystem … | |
search-content | Search Content | read-only | Search screen text, audio transcriptions, input events, memories, and parsed app data. Returns timestamped results with app context and starred markers. For starred work, set starred_only=true and a time range; no sessio… |
synced-devices | Synced Devices | read-only | List this signed-in user's Screenpipe devices that have uploaded Data Sync records, including each device name and last sync time. USE WHEN: the user asks what devices are available, names another device, or asks a cross… |
search-synced-content | Search Synced Content | read-only | Search Data Sync records from this signed-in user's devices. Results include device name, device ID, and timestamp for attribution. USE WHEN: the user asks about another/named device, asks across devices, or local search… |
list-meetings | List Meetings | read-only | List detected meetings (Zoom, Teams, Meet, etc.) with id, duration, app, attendees, and note status. Pass `q` to substring-match title, attendee names/emails, and notes — `q` searches ALL meeting history, so when looking… |
activity-summary | Activity Summary | read-only | Includes up to ten recent starred intervals for this time range, even without captured content. Stars indicate user intent, not duration or completion. Rich activity overview: authoritative active minutes, app/window tim… |
search-elements | Search Elements | read-only | Search UI elements (buttons, links, text fields) from the accessibility tree, filterable by role. USE WHEN: you want a specific UI control or page-structure question — 'find every Submit button I saw', 'list the links in… |
frame-context | Frame Context | read-only | Get full accessibility text, parsed tree nodes, and URLs for a specific frame ID. Use after search-content or get-workflow for a specific moment. Set purpose=automation for paginated nodes preserving exact captured bound… |
export-video | Export Video | writes | Export an MP4 of screen recordings for a time range, with synced microphone audio. Frames are placed at their real timestamps, so the clip's duration matches the wall-clock span you requested (not a sped-up timelapse). R… |
update-memory | Update Memory | writes | Create, update, or delete a persistent memory (facts, preferences, decisions the user wants to remember). To retrieve memories, use search-content with content_type='memory'. To create: provide content + tags. To update:… |
get-feedback | Get AI Feedback | read-only | Search local user ratings and written comments attached to AI-produced notifications, chats, memories, blocks, artifacts, and other targets. Use before generating related work so you preserve what earned up ratings and c… |
send-notification | Send Notification | writes | Send a notification to the screenpipe desktop UI. Use high priority only for time-sensitive failures or decisions needing human attention; routine findings and completed tasks should be normal or low. |
health-check | Health Check | read-only | Check if screenpipe is running and healthy. Returns recording status, frame/audio stats, timestamps. |
list-audio-devices | List Audio Devices | read-only | List available audio input/output devices for recording. |
list-monitors | List Monitors | read-only | List available monitors/screens for capture. |
add-tags | Add Tags | writes | Tag a screen frame (vision) or audio chunk (audio) so it can be retrieved later. Tags are a shared linking layer: use namespaced tags (person:ada, project:atlas, topic:pricing) to connect a capture to a person, project, … |
search-speakers | Search Speakers | read-only | Search for speakers by name prefix. Returns speaker ID, name, and metadata. |
list-unnamed-speakers | List Unnamed Speakers | read-only | List speakers that haven't been named yet. Useful for speaker identification workflow. |
update-speaker | Update Speaker | writes | Rename a speaker or update their metadata. |
merge-speakers | Merge Speakers | destructive | Merge two speakers into one (e.g. when the same person was detected as different speakers). |
start-meeting | Start Meeting | writes | Manually start a meeting recording session. |
stop-meeting | Stop Meeting | writes | Stop the current manual meeting recording session. |
get-meeting | Get Meeting | read-only | Get a meeting by ID: title, attendees, times, and the full note. Pass include_transcript=true to also get the speaker-attributed transcript segments — do this when the note is empty and you need to reconstruct what was s… |
update-meeting | Update Meeting | writes | Update a meeting's mutable fields (title, attendees, note, app, start/end). Partial: only the fields you pass are written, others stay as-is. Use this to save an AI-generated summary into the meeting note — read the curr… |
keyword-search | Keyword Search | read-only | Fast FTS5 keyword search across OCR + audio combined. Returns matches with frame_id, app, timestamp, and text positions. USE WHEN: you have a specific keyword/phrase and want the fastest hit-list (e.g. 'find every screen… |
get-frame-elements | Get Frame Elements | read-only | Get all UI elements for a specific frame. More targeted than search-elements when you already have a frame_id. |
control-recording | Control Recording | writes | Start or stop audio recording. This does not pause or resume screen capture. |
list-pipes | List Pipes | read-only | List the user's pipes (scheduled AI automations) with their enabled state + schedule. USE WHEN: the user asks what automations/pipes exist, or before you create or edit one. |
create-pipe | Create Pipe | writes | Create a pipe — a scheduled AI automation that runs a markdown prompt on a schedule (e.g. 'every day at 9am'). Writes ~/.screenpipe/pipes/<name>/pipe.md, installs it, enables it, and (by default) runs it once to test. US… |
run-pipe | Run Pipe | writes | Run a pipe once immediately (a test run), independent of its schedule. USE WHEN: you just created/edited a pipe and want to verify it, or the user says 'run X now'. Then read pipe-logs to see what it did. |
pipe-logs | Pipe Logs | read-only | Get a pipe's recent execution logs / output. USE WHEN: debugging why a pipe misbehaved, or reading the result of a test run. |
Check your own setup
npx mcpvetter scan --liveBadge
Add this to a README:
[](https://mcpvetter.com/servers/screenpipe-mcp)Publish this server?
Get the MCPVetter verified badge, a re-audit within 24 hours of every npm release, and an email whenever tools, findings, or Claude directory readiness change. $29 per server per month. You prove ownership first, free.