Skip to main content

​
Installation

pip install mengram-ai

​
Commands

​
mengram init

Interactive setup — creates config, vault, and Claude Desktop MCP integration. 
mengram init
mengram init --provider openai --api-key sk-...
mengram init --mcp-only   # only setup MCP integration
FlagDescription
--providerLLM provider: openai, anthropic, ollama
--api-keyAPI key for the provider
--vaultCustom vault path
--homeMengram home directory (default: ~/.mengram)
--no-mcpSkip Claude Desktop MCP setup
--mcp-onlyOnly setup MCP (config must exist)

​
mengram server

Start the MCP server for Claude Desktop, Cursor, or Windsurf. 
mengram server              # local mode (your own LLM keys)
mengram server --cloud      # cloud mode (uses Mengram API)
FlagDescription
--configConfig path (default: ~/.mengram/config.yaml)
--cloudUse cloud API instead of local vault

​
mengram status

Check setup status — config, vault, vector index, Claude Desktop integration. 
mengram status

​
mengram stats

Show vault statistics — entity counts, fact counts, vector index info. 
mengram stats

​
mengram rules

Generate a CLAUDE.md, .cursorrules, or .windsurfrules file from your cloud memory. 
mengram rules                          # default: CLAUDE.md format
mengram rules --format cursorrules     # Cursor format
mengram rules --format windsurf        # Windsurf format
mengram rules --force                  # regenerate (bypass cache)
FlagDescription
--formatOutput format: claude_md, cursorrules, windsurf
--forceRegenerate (bypass cache)

​
mengram hook

Manage Claude Code memory hooks (auto-save + auto-recall + session context). See Claude Code Integration for details. 
mengram hook install              # install all 3 hooks
mengram hook install --every 5    # save every 5th response
mengram hook status               # check hook status
mengram hook uninstall            # remove hook

​
mengram import

Import existing data into memory.

​
mengram import chatgpt

mengram import chatgpt ~/Downloads/chatgpt-export.zip
mengram import chatgpt export.zip --cloud   # use cloud API

​
mengram import obsidian

mengram import obsidian ~/Documents/MyVault
mengram import obsidian vault/ --cloud --chunk-chars 4000

​
mengram import files

mengram import files notes.md journal.txt research.md
mengram import files *.md --cloud

​
mengram api

Start a local REST API server. 
mengram api                    # default: 0.0.0.0:8420
mengram api --port 9000        # custom port

​
mengram web

Start the Web UI with chat and knowledge graph visualization. 
mengram web                    # opens browser automatically
mengram web --port 9000        # custom port
mengram web --no-open          # don't open browser

​
Environment Variables

VariableDescription
MENGRAM_API_KEYCloud API key (starts with om-)
MENGRAM_URLCustom API base URL
MENGRAM_USER_IDDefault user_id