Integration

Windsurf Integration

Add persistent memory to Codeium's Windsurf IDE.

MCP-Powered Memory

ekkOS integrates with Windsurf via the Model Context Protocol (MCP), giving the AI access to 32 memory tools that persist learnings across sessions.

11 Memory Layers

Patterns, directives, secrets, codebase

32 MCP Tools

Search, forge, recall, track, conflict detection

Cross-IDE Sync

Memory syncs across all your environments

Setup Guide

1Get Your ekkOS API Key

1.
Sign up at platform.ekkos.dev
2.
Navigate to Settings → API Keys
3.
Click Create New Key and copy it

2Create MCP Configuration

Create the file .windsurf/mcp.json in your project root:

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

Pro Tip: Replace your_api_key_here with your actual API key from Step 1.

3Restart Windsurf

MCP servers only load on startup. Restart Windsurf to activate ekkOS memory tools.

macOS: Cmd+Q → Reopen
Windows: Alt+F4 → Reopen

4Verify Integration

Open Windsurf's AI chat and ask:

"Search ekkOS memory for patterns about error handling"

If the integration is working, the AI will call the ekkOS_Search tool and return results from your memory layers.

Available Tools (32 Total)

Core Memory Tools

ekkOS_SearchSearch all 11 layers
ekkOS_ForgeCreate patterns
ekkOS_ContextGet full context
ekkOS_RecallRecall past conversations

Directive Tools

ekkOS_DirectiveCreate MUST/NEVER rules
ekkOS_UpdateDirectiveUpdate existing rule
ekkOS_DeleteDirectiveRemove rule
ekkOS_UniversalDirectivesGet global rules

Plan Management

ekkOS_PlanCreate task plans
ekkOS_GenerateAI-generate plans
ekkOS_PlanStatusUpdate plan status
ekkOS_TemplatesReusable templates

Secrets Management

ekkOS_StoreSecretEncrypt & store
ekkOS_GetSecretRetrieve & decrypt
ekkOS_ListSecretsList all secrets
ekkOS_RotateSecretUpdate secret value

32 tools total. View the complete reference at /tools.

Troubleshooting

ekkOS tools not appearing?

• Verify .windsurf/mcp.json exists in your project root
• Check that EKKOS_API_KEY is set correctly (no quotes needed in JSON value)
• Restart Windsurf completely (MCP servers only load on startup)
• Check Windsurf's Output panel → MCP Servers for connection errors

"Invalid API key" error?

• Verify your API key at platform.ekkos.dev
• Ensure there are no extra spaces or quotes around the key in mcp.json
• Check that your ekkOS account has an active subscription (free tier includes 5K calls/month)

Tools appear but AI doesn't use them?

The AI needs to be instructed to use memory tools. Consider adding a CLAUDE.md file to your project root with memory-first instructions.

View CLAUDE.md Setup Guide →

Next Steps

Explore All 32 Tools

Complete MCP tools reference

View tools

CLAUDE.md Setup

Configure AI to use memory proactively

Learn more

Cursor Integration

Setup for Cursor IDE

View guide

Need Help?

Platform Dashboard

platform.ekkos.dev

Support Email

support@ekkos.dev