engram-mcp

MCP server for Engram — gives any AI agent persistent, encrypted memory through the Model Context Protocol.

Quick Start

1. Get an API Key

Create an Engram agent at engram.training/dashboard and copy the agent's API key.

2. Add to your IDE

Claude Code (.mcp.json):

{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-mcp"],
      "env": {
        "ENGRAM_API_KEY": "your-agent-api-key"
      }
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-mcp"],
      "env": {
        "ENGRAM_API_KEY": "your-agent-api-key"
      }
    }
  }
}

Local development (against local API):

{
  "mcpServers": {
    "engram": {
      "command": "node",
      "args": ["./packages/mcp/dist/index.js"],
      "env": {
        "ENGRAM_API_KEY": "your-agent-api-key",
        "ENGRAM_API_URL": "http://localhost:3001"
      }
    }
  }
}

3. Use It

Your AI agent now has access to these tools:

| Tool | Description | |------|-------------| | store_memory | Store a new memory (auto-encrypted with AES-256-GCM) | | recall_memory | Retrieve and decrypt a memory by ID | | search_memories | Search memories by query, type, or tags | | list_memories | List memories with filters (type, pinned, importance) | | delete_memory | Delete a memory by ID | | check_expiring | List memories about to expire | | get_audit_log | View operation audit trail | | upload_media | Upload files to Engram media storage | | get_balance | Check credit balance and monthly usage | | get_pricing | View per-operation credit costs |

Memory Types

Engram supports 13 built-in memory types:

persona · episodic · semantic · working · tool_output · file · procedural · preference · goal · feedback · relational · checkpoint · embedding

Custom types are also supported with the custom: prefix (e.g. custom:meeting_notes).

Encryption

All memory content is encrypted client-side before being sent to Engram:

• Algorithm: AES-256-GCM
• Key derivation: PBKDF2 (100,000 iterations, SHA-256) from your API key
• Per-memory: Each memory gets a unique random salt and IV
• Decryption: Automatic when using recall_memory

The Engram server never sees your plaintext content.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | ENGRAM_API_KEY | ✅ | — | Your Engram agent API key | | ENGRAM_API_URL | ❌ | https://api.engram.training | API base URL |

Development

# Install dependencies
cd packages/mcp && npm install

# Run in development mode
ENGRAM_API_KEY=your-key npm run dev

# Type check
npm run typecheck

# Build
npm run build

License

MIT