mcpbeat Sign in

Perenna MCP Server

local only

Perenna runs on your own machine — the client starts it, so there is no endpoint to ping. 77 installs a week from pypi. Last commit 9 Sep 2026.

A lightweight, Git-backed permanent memory for AI agents.

Installs per day peak 57 · avg 20 · -41% w/w
a month agotoday
77
Installs / week
pypi · perenna
61
Stars
1 open issue
9 Sep 2026
Last commit
from GitHub
MIT
License
Python

What the code does

We read the source, 3 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

        raw = yaml.load(frontmatter_text, Loader=_UniqueSafeLoader)
    private_key = directory / "id_ed25519"

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add perenna -- uvx perenna
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "perenna": {
      "command": "uvx",
      "args": [
        "perenna"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.perenna]
command = "uvx"
args = ["perenna"]
.cursor/mcp.json
{
  "mcpServers": {
    "perenna": {
      "command": "uvx",
      "args": [
        "perenna"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "perenna": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "perenna"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: PERENNA_GIT_REMOTE (Git remote name used for optional synchronization (for example, origin); leave unset for local-only operation), VEXOR_API_KEY (Embedding provider API key (optional; overrides a stored key; providers can also be configured via `vexor init`)), VEXOR_REMOTE_RERANK_API_KEY (Remote reranker API key (optional; overrides a stored key; only needed when rerank is set to remote)), VEXOR_CONFIG_JSON (Non-secret Vexor config as a JSON object, e.g. {"provider": "gemini", "rerank": "bm25"} (optional; merged over ~/.vexor/config.json; credential fields are rejected, use the dedicated variables)).

Alternatives to Perenna

same job, measured the same way
MemAuthority
by iasi777

Git-backed long-term memory authority for AI agents via MCP.

local only
Waggle MCP
by abhigyan-shekhar

Persistent graph-backed conversational memory for AI agents.

63 installs/wk local only
agentmem
by oxgeneral

Lightweight persistent memory for AI agents. Hybrid search. 16 tools. One SQLite file.

local only
Lore
by jordanhindo

Lightweight MCP for infinite agent memory. Any agent, any session, anytime.

51 installs/wk local only
Akb
by dnotitia

Git-backed org memory for AI agents — hybrid search, tables, files & a URI graph over MCP.

54 installs/wk local only
MCP Light Memory
by peterpirog

Local-first persistent memory for coding agents and MCP clients.

local only
PMB AI
by oleksiijko

Local-first persistent memory for AI coding agents.

278 installs/wk local only
Engram
by rwnalds

Git-backed markdown memory for AI agents; search hides superseded and archived notes.

local only

Perenna — questions

Answers built from our own checks of this server.

Why is there no uptime for Perenna?
Perenna runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package perenna was installed 77 times last week.
How do I connect Perenna?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls perenna straight from pypi; nothing to host, nothing to sign up for.
How many people use Perenna?
The pypi package perenna was installed 77 times in the last week. Week over week that is -41%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Perenna open source?
Yes — it is published under the MIT licence, written in Python, 61 stars on GitHub and 1 open issue. The source link is on this page, so you can read exactly what it does with your data before you connect it.