ekkos

ekkOS Memory MCP Server - Universal AI memory across Cursor, Windsurf, VS Code

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio ekkos-technologies-inc-ekkos-mcp-server npx -y @ekkos/mcp-server \
  --env EKKOS_API_KEY="your-api-key-here" \
  --env EKKOS_USER_ID="your-user-id-here"

How to use

This ekkOS MCP server provides persistent memory for your AI assistants, enabling cross-session recall, pattern saving, and rule-based governance. It exposes a suite of memory tools that let your agent search memory, capture and store patterns, manage directives, and verify actions against rules before execution. The server is designed to work with popular MCP-enabled tooling such as Cursor, Windsurf, VS Code, Claude Code, and other MCP-compatible integrations. To use it, configure a local or IDE-specific mcp.json file to point at the server, supply your API key and user ID, and then start the MCP server so your IDE can begin querying persistent memory across sessions. The server integrates with the 42 memory tools across 11 categories, including core memory, pattern tracking, utilities, plan management, secrets, schema awareness, portability, project setup, session management, auto-learning, and pattern relationships, enabling a broad set of memory-backed capabilities for your AI.

Once configured, your AI can perform memory searches, save successful solutions as patterns, set MUST/NEVER/PREFER/AVOID directives, and check actions against these directives before execution. You can save and retrieve patterns, track outcomes, index schemas, manage secrets, and generate plans or templates, all backed by ekkOS memory. This makes your AI more reliable and context-aware across multiple sessions and projects.

How to install

Prerequisites:

Node.js 18+ and npm installed on your system
Access to the internet to fetch the MCP server package

Installation steps:

Install the MCP server globally (recommended approach):

npm install -g @ekkos/mcp-server

Alternative: run directly via npx (no global install required):

npm install -g @ekkos/mcp-server  # optional for convenience
npx -y @ekkos/mcp-server

Obtain API credentials:

Visit https://platform.ekkos.dev
Sign in or create an account
Copy your API key and User ID from the dashboard

Configure the MCP client in your IDE:

For Claude Code, Windsurf, Cursor, or other supported tools, set up the mcp configuration to point to the server and provide your API key and user ID as needed (see the README for exact snippets).

Start the server and connect the IDE:

Ensure your environment variables are set (as shown in the mcp_config example) and start the server so your IDE can communicate with it.

Additional notes

Tips and common issues:

Ensure Node.js 18+ is installed to avoid compatibility issues.
Keep your EKKOS_API_KEY and EKKOS_USER_ID secure; do not commit them to source control.
If the MCP server is not appearing in your IDE, verify that your config file uses the correct server name (e.g., 'ekkos-memory') and that the server process is running.
If authentication errors occur, re-check your API key status on the ekkos platform and ensure it has not expired.
The server supports a wide range of tools; consult docs at docs.ekkos.dev for detailed tool usage and examples, including how to use specific tools like ekkOS_Search, ekkOS_Forge, ekkOS_Summary, and more.
When running behind a proxy or corporate network, ensure the correct network access and environment variables are configured for API requests.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.