MCP server
Memoria
Persistent, plain-text memory for agents: markdown you own, hybrid search…
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.3.2
- Listing updated
- 2 days ago
About Memoria
Memoria is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
Persistent, plain-text memory for agents: markdown you own, hybrid search, self-maintenance.
Install
Run in a terminal
claude mcp add memoria-mcp -- npx -y @agrippa87/memoria-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"memoria-mcp": {
"command": "npx",
"args": [
"-y",
"@agrippa87/memoria-mcp"
]
}
}
}Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"memoria-mcp": {
"command": "npx",
"args": [
"-y",
"@agrippa87/memoria-mcp"
]
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"memoria-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agrippa87/memoria-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"memoria-mcp": {
"command": "npx",
"args": [
"-y",
"@agrippa87/memoria-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"memoria-mcp": {
"command": "npx",
"args": [
"-y",
"@agrippa87/memoria-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
MEMORIA_DIRRoot directory of the memory store. Defaults to ~/.memoria locally (or /data/memoria in Docker).MEMORIA_EMBEDDINGSEmbedding provider: auto (local MiniLM if installed, else hash; never remote), openai (explicit opt-in: sends content to OpenAI), minilm or hash.MEMORIA_API_KEYBearer token authenticating /mcp, /ingest and /dashboard/api. Required for the HTTP transport.RequiredMEMORIA_OAUTH_CLIENT_SECRETOAuth 2.1 client secret for remote clients (claude.ai). Required when BIND_ALL=true; keep it distinct from the API key.MEMORIA_ENCRYPTION_KEYAES-256-GCM master key (64 hex chars) for the collector's encrypted buffer and credential store. Required when BIND_ALL=true.MEMORIA_PUBLIC_URLExternal URL of this server. Pins the OAuth discovery metadata so it is never derived from the Host header. Required when exposed.MEMORIA_DIRRoot directory of the memory store. Defaults to ~/.memoria locally (or /data/memoria in Docker).
Pricing
Open source
Memoria FAQ
Is Memoria free?
Yes. Memoria is open source, so you can use and self-host it for free.
How do I add Memoria to Claude Code?
Run this command in your terminal: claude mcp add memoria-mcp -- npx -y @agrippa87/memoria-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.