English Français العربية

io.github.parallelromb/smara

Official registry AI and agents

Persistent cross-platform memory for AI agents with Ebbinghaus decay scoring.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @smara/mcp-server
Claude Code 
claude mcp add smara -e 'SMARA_API_KEY=<your smara_api_key>' -- npx -y @smara/mcp-server@2.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "smara": {
            "command": "npx",
            "args": [
                "-y",
                "@smara/mcp-server@2.0.2"
            ],
            "env": {
                "SMARA_API_KEY": "<your smara_api_key>"
            }
        }
    }
}

Environment variables

  • SMARA_API_KEY required secret Your Smara API key from smara.io

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @smara/mcp-server
  2. Quick Start
  3. Tools
  4. How It Works
  5. Works With
  6. Environment Variables
  7. License

@smara/mcp-server

MCP server for the Smara Memory API — give any AI app persistent memory with Temporal Memory Scoring™.

Quick Start

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "smara": {
      "command": "npx",
      "args": ["-y", "@smara/mcp-server"],
      "env": {
        "SMARA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Get a free API key at smara.io (10,000 memories, no credit card).

Tools

ToolDescription
store_memoryStore a fact about a user with importance scoring
search_memoriesSemantic search with Temporal Memory Scoring™
get_user_contextPre-formatted context string for LLM system prompts
delete_memoryDelete a specific memory
get_usageCheck plan limits and memory count

How It Works

Smara uses Temporal Memory Scoring™ — a proprietary ranking system that makes AI memory work like human recall. Memories naturally fade over time, modulated by importance and access patterns. Recent, critical memories surface first. Stale, trivial ones fade. Contradictions are auto-detected and resolved.

Works With

  • Claude Desktop
  • Claude Code
  • Cursor
  • Windsurf
  • VS Code (GitHub Copilot)
  • Any MCP-compatible client

Environment Variables

VariableRequiredDefault
SMARA_API_KEYYes—
SMARA_API_URLNohttps://api.smara.io

License

MIT

Frequently asked questions

What is io.github.parallelromb/smara?

Persistent cross-platform memory for AI agents with Ebbinghaus decay scoring.

How do I install io.github.parallelromb/smara?

It runs on your machine. In Claude Code: claude mcp add smara -e 'SMARA_API_KEY=<your smara_api_key>' -- npx -y @smara/mcp-server@2.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.parallelromb/smara need an API key?

Yes. It expects SMARA_API_KEY, which you set in its configuration.

Is io.github.parallelromb/smara open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.parallelromb/smara?

It is published by smara-io. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.