Skip to content

feat(mcp): add Screenpipe to the built-in catalog - #201

Merged
kannandreams merged 3 commits into
kannandreams:mainfrom
louis030195:feat/add-screenpipe-mcp
Oct 2, 2026
Merged

kannandreams merged 3 commits into
kannandreams:mainfrom
louis030195:feat/add-screenpipe-mcp

Conversation

@louis030195

Copy link
Copy Markdown
Contributor

Adds Screenpipe to the built-in MCP catalog so tuff add mcp screenpipe can configure access to locally captured screen text, audio and meeting history. The entry uses the official documented npx -y screenpipe-mcp@latest command and forwards SCREENPIPE_LOCAL_API_KEY as an environment reference.

The description explains that Screenpipe must already be running on localhost:3030, where to obtain the key, and that configured cloud features can send context off-device. Screenpipe is source-available under the Screenpipe Commercial License. Current plans are linked rather than copied into the catalog. Includes an Unreleased changelog entry; the catalog website is generated from the TOML.

Sources: official MCP setup and tool documentation, license, product and plans.

Validation:

  • cargo +stable test -p tuff-core catalog::tests --locked (6 passed).
  • cargo +stable test -p tuffcli mcp_catalog --locked (3 passed).
  • npm --prefix website run build (49 pages built).
  • Generated catalog checked for one Screenpipe entry, the documented command and the key reference; rendered catalog HTML contains the entry.
  • git diff --check.
  • Temporary-project smoke test: tuff init, then tuff add mcp screenpipe -a open-agents -y; verified the generated MCP configuration contains the package command and an environment reference for the key.

These checks validate the catalog and generated website. They do not run Screenpipe or query recordings. Used Rust 1.98.1 and Node 24.20.0 locally.

Disclosure: I maintain Screenpipe. This contribution was prepared with Codex.

@kannandreams
kannandreams force-pushed the feat/add-screenpipe-mcp branch from 27706ff to 1ee7508 Compare October 2, 2026 21:29
@kannandreams

kannandreams commented Oct 2, 2026 •

Copy link
Copy Markdown
Owner

Thanks for adding Screenpipe, and for disclosing that you maintain it. I checked the entry against the screenpipe-mcp README: the npx -y screenpipe-mcp@latest command, SCREENPIPE_LOCAL_API_KEY, port 3030, and the five tools all match.

I pushed two changes to your branch:

  • Rebased onto main, which resolved the changelog conflict. The entry is now under Unreleased in the format the other entries use.
  • Added screenpipe to the catalog ids in the Tuff CLI guide and the Claude Code plugin skill, which list every entry.

cargo test -p tuff-core catalog, cargo test -p tuffcli, and the website build pass, and tuff mcp catalog lists the entry. It will ship in the next release.

@louis030195
One request please : once it's released, could you add a line to the screenpipe-mcp setup docs, such as "Install with Tuff: tuff add mcp screenpipe"? It configures the server for Claude Code, Codex, Cursor, OpenCode, and Open Agents in one command, which may help your users who work with more than one of them.

@kannandreams
kannandreams merged commit dd7d149 into kannandreams:main Oct 2, 2026
2 checks passed
kannandreams added a commit that referenced this pull request Oct 2, 2026
States when a server is added to the built-in catalog, so vendor pull requests like #201 get a consistent answer, and lists the files and checks an entry needs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants