AiMemoryMcp 1.0.0

AI Memory MCP

A local MCP server that gives any AI assistant persistent memory. Save and retrieve Q&A responses across sessions using a local SQLite database.

Works with Claude Desktop, Claude Code, VS Code Copilot, Cursor, and any MCP-compatible client.

Install

Requires: .NET 8 SDK

dotnet tool install -g AiMemoryMcp

That's it. The database is created automatically at ~/.ai_memory.db.

Configure Your AI Client

Claude Desktop

Edit ~/.config/claude_desktop_config.json (Linux) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

{
  "mcpServers": {
    "ai-memory": {
      "command": "ai-memory-mcp"
    }
  }
}

Claude Code

Add to .claude/mcp.json or ~/.claude/mcp.json:

{
  "mcpServers": {
    "ai-memory": {
      "command": "ai-memory-mcp"
    }
  }
}

VS Code / Cursor

Add to .vscode/mcp.json:

{
  "servers": {
    "ai-memory": {
      "command": "ai-memory-mcp"
    }
  }
}

What It Does

Once configured, your AI assistant gets these tools:

Stale entries (older than 90 days) are automatically flagged with [STALE] in results. Duplicate questions are detected and warned about on save.

REST API

A REST API runs alongside the MCP server on http://localhost:5100.

Examples

# Save a response
curl -X POST http://localhost:5100/api/responses \
  -H "Content-Type: application/json" \
  -d '{"question":"How do I reverse a list in Python?","answer":"Use list.reverse() or list[::-1]","sourceAi":"chatgpt","tags":"python,lists"}'

# Search
curl "http://localhost:5100/api/responses/search?query=python"

# Update
curl -X PUT http://localhost:5100/api/responses/1 \
  -H "Content-Type: application/json" \
  -d '{"answer":"Updated answer text"}'

# Export as markdown
curl -o export.md "http://localhost:5100/api/responses/export?format=markdown"

Configuration

All configuration is via environment variables:

Example with custom config:

{
  "mcpServers": {
    "ai-memory": {
      "command": "ai-memory-mcp",
      "env": {
        "AI_MEMORY_DB_PATH": "~/my-memories.db",
        "AIMEMORY_API_PORT": "5200",
        "AI_MEMORY_STALE_DAYS": "180"
      }
    }
  }
}

Build from Source

git clone https://github.com/sravanchenna/AiMemoryMcp.git
cd AiMemoryMcp/AiMemoryMcp
dotnet run

License

MIT