Integration

Claude Code Integration

Add persistent memory to Anthropic's Claude Code CLI.

About Claude Code

Claude Code is Anthropic's official CLI tool for using Claude in your terminal. It supports MCP (Model Context Protocol), which allows ekkOS to provide persistent memory across all your coding sessions.

Configuration

Step 1: Find your settings file

Claude Code stores its configuration at:

# macOS / Linux

~/.claude/settings.json

# Windows

%USERPROFILE%\.claude\settings.json

Step 2: Add ekkOS MCP server

Add or merge the following into your settings.json:

{
  "mcpServers": {
    "ekkos-memory": {
      "command": "npx",
      "args": ["-y", "@ekkos/mcp-server"],
      "env": {
        "EKKOS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Step 3: Restart Claude Code

Close your terminal and reopen it. Claude Code will automatically load the MCP server.

Getting Your API Key

1Go to platform.ekkos.dev
2Sign up or log in with GitHub
3Go to Settings → API Keys
4Click "Generate New Key"

Verify Installation

After restarting, ask Claude to use memory:

"Search my memory for recent patterns"

"What do you remember about this project?"

Success

If Claude uses tools like ekko or search_memory, the integration is working.

Available Memory Tools

ekko

Search memory for patterns and solutions

crystallize

Save important decisions permanently

reflex

Validate suggestions against your history

forge_insight

Create new patterns from learnings

Troubleshooting

MCP server not loading?

• Verify your settings.json is valid JSON
• Check Node.js 18+ is installed: node --version
• Try running manually: EKKOS_API_KEY=xxx npx @ekkos/mcp-server

Next Steps

MCP Tools Reference

Complete tool documentation

View tools

The Golden Loop

How memory improves over time

Learn more