A lightweight, Git-backed permanent memory for AI agents.
Connect Runs on your machine
claude mcp add perenna -e PERENNA_GIT_REMOTE=<PERENNA_GIT_REMOTE> -e VEXOR_API_KEY=<VEXOR_API_KEY> -e VEXOR_REMOTE_RERANK_API_KEY=<VEXOR_REMOTE_RERANK_API_KEY> -e VEXOR_CONFIG_JSON=<VEXOR_CONFIG_JSON> -- uvx perenna==0.4.1
{
"mcpServers": {
"perenna": {
"command": "uvx",
"args": [
"perenna==0.4.1"
],
"env": {
"PERENNA_GIT_REMOTE": "<PERENNA_GIT_REMOTE>",
"VEXOR_API_KEY": "<VEXOR_API_KEY>",
"VEXOR_REMOTE_RERANK_API_KEY": "<VEXOR_REMOTE_RERANK_API_KEY>",
"VEXOR_CONFIG_JSON": "<VEXOR_CONFIG_JSON>"
}
}
}
}
{
"mcpServers": {
"perenna": {
"command": "uvx",
"args": [
"perenna==0.4.1"
],
"env": {
"PERENNA_GIT_REMOTE": "<PERENNA_GIT_REMOTE>",
"VEXOR_API_KEY": "<VEXOR_API_KEY>",
"VEXOR_REMOTE_RERANK_API_KEY": "<VEXOR_REMOTE_RERANK_API_KEY>",
"VEXOR_CONFIG_JSON": "<VEXOR_CONFIG_JSON>"
}
}
}
}
{
"servers": {
"perenna": {
"type": "stdio",
"command": "uvx",
"args": [
"perenna==0.4.1"
],
"env": {
"PERENNA_GIT_REMOTE": "<PERENNA_GIT_REMOTE>",
"VEXOR_API_KEY": "<VEXOR_API_KEY>",
"VEXOR_REMOTE_RERANK_API_KEY": "<VEXOR_REMOTE_RERANK_API_KEY>",
"VEXOR_CONFIG_JSON": "<VEXOR_CONFIG_JSON>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
PERENNA_GIT_REMOTEOptional | Git remote name used for optional synchronization (for example, origin); leave unset for local-only operation |
VEXOR_API_KEYOptional, secret | Embedding provider API key (optional; overrides a stored key; providers can also be configured via `vexor init`) |
VEXOR_REMOTE_RERANK_API_KEYOptional, secret | Remote reranker API key (optional; overrides a stored key; only needed when rerank is set to remote) |
VEXOR_CONFIG_JSONOptional | 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) |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 28 Aug 2026 |
| Last updated | 28 Aug 2026 |
| Registry name | io.github.scarletkc/perenna |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
