Screenpipe MCP Server: Setup for Claude, Cursor and Other Apps

• Searches your screen text, spoken audio and memories

  Searches what was on your screen and what was said, with timestamps and the app it came from. It also covers input events, saved memories and parsed app data, and you can filter by time range, app or starred moments.

  Try: “Find where I read about the Q3 pricing change last week.”

  Read · search-content

• Fast keyword hunt across screen text and audio

  Looks up a specific word or phrase across screen text and audio and returns each hit with its frame ID, app and time.

  Try: “Find every screen where I typed "invoice 4821".”

  Read · keyword-search

• Summarizes what you did in a time range

  Gives an overview of active minutes, apps and windows used, documents edited, key text and audio transcripts for the period you name.

  Try: “What did I work on this morning, and for how long?”

  Read · activity-summary

• Finds buttons, links and fields you saw on screen

  Searches interface elements captured from the accessibility tree, and you can filter by role such as button or link.

  Try: “List every Submit button I saw in the last hour.”

  Read · search-elements

• Lists every interface element in one frame

  Returns all interface elements for a single captured frame when you already have its ID.

  Try: “Show the elements in that frame.”

  Read · get-frame-elements

• Reads the full text and links of one screen capture

  Gets the full accessibility text, parsed nodes and URLs for a specific frame ID, usually after a search found it.

  Try: “Open the frame from the search and give me the whole page text.”

  Read · frame-context

• Lists repeated work Screenpipe has spotted

  Finds the workflows Screenpipe saved from your history: repeated work, triggers and outcomes. It only reads the catalog and does not run anything. An empty result can mean no catalog has been built yet.

  Try: “Which tasks do I repeat most often?”

  Read · list-workflows

• Reads the steps of one saved workflow

  Returns a workflow's ordered steps, source quotes and the screen elements seen at the time. It is evidence from your history, not an automation that can be replayed.

  Try: “Show me the steps of my weekly report workflow.”

  Read · get-workflow

• Lists meetings it detected

  Lists detected meetings from apps like Zoom, Teams or Meet, with duration, attendees and note status. You can search by title, attendee or note text.

  Try: “When did I last talk to Noah?”

  Read · list-meetings

• Gets one meeting with its note and transcript

  Returns a meeting's title, attendees, times and note. It can also return the speaker-attributed transcript.

  Try: “Get the transcript of yesterday's standup.”

  Read · get-meeting

• Edits a meeting's title, attendees or note

  Changes the fields you pass and leaves the rest alone. The tool description suggests reading the current note first so a summary is added without overwriting your writing.

  Try: “Add a summary of that meeting under a Summary heading in its note.”

  Write · update-meeting

• Starts a manual meeting recording

  Starts a meeting session by hand, for meetings the app did not detect.

  Try: “Start recording a meeting now.”

  Write · start-meeting

• Stops the manual meeting recording

  Ends the manual meeting session you started.

  Try: “Stop the meeting recording.”

  Write · stop-meeting

• Finds speakers by name

  Searches known speakers by name prefix and returns their ID, name and details.

  Try: “Find the speaker called Ada.”

  Read · search-speakers

• Lists voices that have no name yet

  Shows speakers Screenpipe has detected but not yet named, so you can label them.

  Try: “Which speakers are still unnamed?”

  Read · list-unnamed-speakers

• Renames a speaker

  Renames a speaker or updates their details.

  Try: “Rename speaker 12 to Ada Chen.”

  Write · update-speaker

• Merges two speakers into one

  Combines two speakers when the same person was detected as two voices.

  Try: “Merge speaker 12 and speaker 15.”

  Write · merge-speakers

• Creates, edits or deletes a saved memory

  Saves facts, preferences or decisions you want kept, edits one by ID, or deletes it when delete is set to true.

  Try: “Remember that the Atlas project deadline is 14 March.”

  Delete · update-memory

• Tags a screen frame or audio clip

  Adds tags such as person:ada or project:atlas to a frame or audio chunk so you can find it later.

  Try: “Tag that screenshot with project:atlas.”

  Write · add-tags

• Finds your ratings on AI-made notes and chats

  Searches local ratings and comments you left on AI output, so new work can follow what you liked.

  Try: “Check my past feedback on summaries before writing this one.”

  Read · get-feedback

• Exports a screen recording clip as MP4

  Builds an MP4 of your screen for a time range with microphone audio, at real speed, and returns the file path. Long ranges can take minutes.

  Try: “Export my screen from 2pm to 2:30pm as a video.”

  Write · export-video

• Shows a notification in the Screenpipe app

  Sends a notification to the Screenpipe desktop app. High priority is meant for time-sensitive problems.

  Try: “Notify me when the export is done.”

  Write · send-notification

• Checks that Screenpipe is running

  Reports recording status, frame and audio stats and timestamps.

  Try: “Is Screenpipe recording right now?”

  Read · health-check

• Lists audio devices

  Lists audio input and output devices available for recording.

  Try: “Which microphones can Screenpipe use?”

  Read · list-audio-devices

• Lists screens it can capture

  Lists the monitors available for screen capture.

  Try: “Which monitors is Screenpipe capturing?”

  Read · list-monitors

• Starts or stops audio recording

  Starts or stops audio recording. It does not pause or resume screen capture.

  Try: “Stop audio recording for now.”

  Write · control-recording

• Lists your scheduled AI automations

  Lists your pipes, which are scheduled AI tasks, with whether each is on and its schedule.

  Try: “What automations do I have set up?”

  Read · list-pipes

• Creates a scheduled AI automation

  Creates a pipe from a markdown prompt and a schedule such as every day at 9am. It writes a file under ~/.screenpipe/pipes, enables it, and by default runs it once as a test.

  Try: “Every weekday at 5pm, summarize my day and save it.”

  Runs code · create-pipe

• Runs a pipe once right now

  Runs a pipe immediately as a test, regardless of its schedule.

  Try: “Run the daily summary pipe now.”

  Runs code · run-pipe

• Shows a pipe's recent output

  Returns a pipe's recent logs and output, for debugging or reading a test run.

  Try: “Why did my daily summary pipe fail?”

  Read · pipe-logs

• Lists or reads Screenpipe's bundled how-to guides

  Lists the bundled workflow guides for recall, meetings, handoffs and bug reports, or returns one by exact name. Loading a guide gives no new permissions.

  Try: “List the Screenpipe guides you have, then use the meeting one.”

  Read · screenpipe-skills

• Lists your devices that sync data

  Lists the devices on your signed-in account that uploaded Data Sync records, with last sync time.

  Try: “Which of my devices have synced?”

  Network · synced-devices

• Searches synced records from your other devices

  Searches Data Sync records across your signed-in devices, with device name and time on each result.

  Try: “What was I reading on my laptop yesterday?”

  Network · search-synced-content

• Searches your whole organization's data (enterprise)

  For enterprise setups. Searches telemetry from every device enrolled under your organization's license. It needs an enterprise token.

  Try: “What did the team discuss about the release?”

  Network · team-search

• Lists devices enrolled in your organization (enterprise)

  For enterprise setups. Lists enrolled devices with hostname, OS, app version and last seen time.

  Try: “Which team devices have not reported in a week?”

  Network · team-devices

• Dumps the organization's records for a time window (enterprise)

  For enterprise setups. Returns raw telemetry and the outputs of enterprise pipes for a time window, oldest first.

  Try: “Pull last week's team records.”

  Network · team-records

• Reads one redacted team screenshot (enterprise)

  For enterprise setups. Returns one PII-redacted screenshot from a device when it was uploaded. It needs an admin token.

  Try: “Show me that team frame.”

  Network · team-frame

Watch out for

• Your whole screen history is readable by the assistant

  Search results can include anything that appeared on screen or was said near your microphone. Pause recording or exclude apps you do not want searchable. github.com

• It can delete saved memories

  The memory tool deletes an entry when delete is set to true. Ask the assistant to confirm before it removes anything. github.com

• It can create automations that run on a schedule

  The pipe tools write a pipe file and run its prompt on a schedule. Review each pipe before you leave it enabled. github.com

• The network mode needs a secret

  The HTTP mode listens on your own machine by default. If you open it to your network, set the bearer key and keep it private. github.com

Security advisories