NestDaddy

Perenna

io.github.scarletkc/perenna ยท v0.4.1

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

Connect Runs on your machine

Terminal
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
claude_desktop_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>"
      }
    }
  }
}
~/.cursor/mcp.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>"
      }
    }
  }
}
.vscode/mcp.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

NameDescription
PERENNA_GIT_REMOTE
Optional
Git remote name used for optional synchronization (for example, origin); leave unset for local-only operation
VEXOR_API_KEY
Optional, secret
Embedding provider API key (optional; overrides a stored key; providers can also be configured via `vexor init`)
VEXOR_REMOTE_RERANK_API_KEY
Optional, secret
Remote reranker API key (optional; overrides a stored key; only needed when rerank is set to remote)
VEXOR_CONFIG_JSON
Optional
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 published28 Aug 2026
Last updated28 Aug 2026
Registry nameio.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.