Perenna MCP Server

A lightweight, Git-backed permanent memory for AI agents. Claude Code, Codex, ChatGPT, Cursor, and other MCP clients can share durable memories without sharing a vendor account or conversation history. It runs locally over stdio via the published package.

People who work with agent memory, git backed and self hosted and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-09-09 · ★ 40 · #59 OF 304 MAINTAINED MEMORY · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Perenna

Claude Code

claude mcp add scarletkc-perenna -- uvx perenna

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "scarletkc-perenna": {
      "command": "uvx",
      "args": [
        "perenna"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-08-21 - young repo, little track record yet

license MIT - declared in the repository

pypi package perenna - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.scarletkc is GitHub-verified and matches the repo owner

03 · What Perenna can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.4.1 · 2026-08-28

Automated release for Perenna v0.4.1. · Plugin runtime updates · Codex and Claude plugins now start uvx perenna@latest mcp, resolving the · latest stable Perenna release from PyPI and caching its environment through…

v0.4.0 · 2026-08-27

Automated release for Perenna v0.4.0. · Persistent Git synchronization settings · A successful perenna sync setup <repository-url> now saves the selected · Git remote in the Perenna home. Future Perenna processes use…

v0.3.0 · 2026-08-25

Automated release for Perenna v0.3.0. · Highlights · Connect ChatGPT to Perenna on a developer machine or private host through · OpenAI Secure MCP Tunnel. The new perenna serve --local-only mode serves · Streamable…

04 · Who maintains Perenna

Perenna is maintained by scarletkc. We track 2 MCP servers from scarletkc - 2 actively maintained, 281 combined GitHub stars, oldest repo from Nov 2025. Full record: all servers from scarletkc.

Vexor A semantic search engine for files and code. ★ 241

05 · Facts

repository: github.com/scarletkc/perenna
category: memory - ranked #59 of 304 actively-maintained memory servers as of 2026-09-18.
release cadence: 7 releases in the last 90 days (latest 2026-08-28)
registry: io.github.scarletkc/perenna (active, first published 2026-08-23 · 7 versions)
packages: pypi:perenna

06 · Perenna FAQ

What is Perenna?

Is Perenna still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-09 and it shipped 7 releases in the last 90 days. We re-verify nightly.

How do I install Perenna?

Run `uvx perenna`. You can also paste the ready-made client config above.

Does Perenna run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Perenna

Alternatives to Perenna

Maintained memory servers if Perenna isn't the fit.

Pairs well with

Servers that cover what Perenna doesn't - only shown when the pairing reason fits the companion.

More memory MCP servers · Filamental · Clude · Alaya MCP · Reelier · Brainkb

More Python MCP servers · Vexor · Ephemeris MCP · Clearfront · Scout MCP Local · Scrape Badger · see all