Screenpipe API

Query the user's local and synced-device Screenpipe data via the REST API at localhost:3030. Use for screen activity, meetings, apps, productivity, other-device or cross-device history, media export, retranscription, or connected services.

22,429 stars 2,305 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add screenpipe/screenpipe --skill screenpipe-api
Manual install
git clone --depth 1 https://github.com/screenpipe/screenpipe.git /tmp/screenpipe
mkdir -p ~/.claude/skills
cp -r /tmp/screenpipe/.claude/skills/screenpipe-api ~/.claude/skills/screenpipe-api

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Screenpipe API

Local REST API at `http://localhost:3030`. Full reference (60+ endpoints): https://docs.screenpi.pe/llms-full.txt

## Authentication

**ALL requests require authentication.** Add the auth header to every curl call:

```bash
curl -H "Authorization: Bearer $SCREENPIPE_LOCAL_API_KEY" \
  -H "X-Screenpipe-Client: api" \
  -H "X-Screenpipe-Agent: unknown" \
  "http://localhost:3030/..."
```

The fixed `X-Screenpipe-Client: api` value attributes a successful, nonempty
external retrieval to the API surface. Never put an agent name, customer name,
project, prompt, or other dynamic value in this header.
Include both attribution headers above on REST retrievals. The installer sets
`X-Screenpipe-Agent` to a fixed app identifier; preserve that value. If this is
an unconfigured reference, leave it as `unknown`. Never substitute a project,
user, model, prompt, or other dynamic identifier.

The `$SCREENPIPE_LOCAL_API_KEY` env var is already set in your environment. Without it you get 403. The only exception is `/health` (no auth needed).

## Context Window Protection

API responses can be large. Always write curl output to a file first (`curl ... -o /tmp/sp_result.json`), check size (`wc -c /tmp/sp_result.json`), and if over 5KB read only the first 50-100 lines. Extract what you need with `jq`. NEVER dump full large responses into context.
Read the full skill on GitHub

Details

Skill name
screenpipe-api
Path
.claude/skills/screenpipe-api/SKILL.md
Repo updated
17 November 2026

FAQ

What does the Screenpipe API skill do?

Query the user's local and synced-device Screenpipe data via the REST API at localhost:3030. Use for screen activity, meetings, apps, productivity, other-device or cross-device history, media export, retranscription, or connected services.

How do I install the Screenpipe API skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add screenpipe/screenpipe --skill screenpipe-api. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Screenpipe API popular?

It lives in screenpipe/screenpipe, which has 22,429 GitHub stars and 2,305 forks, and is included in 1 curated skill list.

Related skills

Develop Screenpipe Windows

22k

screenpipe/screenpipe

Develop and test Screenpipe Windows-native changes on a disposable Azure VM created from the prepared Screenpipe Windows dev image. Use for Windows compiler, process, service, local API, desktop, capture, installer, or permission behavior. Do not use for React-only work proved by the browser mock.

Software DevelopmentIn 1 list2.3k

Release

22k

screenpipe/screenpipe

Release the screenpipe monorepo. Bumps versions, triggers GitHub Actions for app, CLI, MCP, and JS packages.

Git & Code ReviewIn 1 list2.3k

Render HTML Report

22k

screenpipe/screenpipe

Produce a human-facing visual report — a chart, dashboard, scorecard, or styled summary — that renders as a live page in the screenpipe viewer instead of plain text. Use when the task asks for a visual/graphical output rather than a plain note; do NOT use for plain text or raw data (prefer a markdown note for those).

Productivity & NotesIn 1 list2.3k

Screenpipe API

22k

screenpipe/screenpipe

Query the user's local and synced-device data via the screenpipe REST API at localhost:3030 — recordings, audio, UI, meetings, connected services, and memory. Use for starred work, screen activity, other-device or cross-device history, productivity, media export, connections, durable memory, or discovering and automating saved workflows.

Software DevelopmentIn 1 list2.3k

Screenpipe Bug Report

22k

screenpipe/screenpipe

Turn a recorded software failure into a reproducible bug report with timestamps and observed behavior.

Software DevelopmentIn 1 list2.3k

Verify Change

31k

ComposioHQ/composio

Maintain resumable task records, select repository verification profiles, inspect revision-bound receipts, and carry work between coding agents. Use for substantial SDK or CLI work spanning sessions, evidence review, or carrying work between coding agents; use package-specific skills for implementation and ordinary small edits.

Software DevelopmentIn 1 list5k

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.