MCP Server for AI Memory: Connect Alma to Claude Desktop and Cursor

April 2026 · 6 min read · Developer

The Model Context Protocol (MCP) lets AI clients connect to external tools and data sources. Alma's MCP server gives Claude Desktop, Cursor, Windsurf, and any MCP-compatible client access to 35 tools for persistent memory, context assembly, and cognitive identity.

Quick Setup

Step 1: Get your API key from alma.olivares.ai/settings (API Keys tab).

Step 2: Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "alma": {
      "command": "npx",
      "args": ["-y", "@olivaresai/alma-mcp"],
      "env": { "ALMA_API_KEY": "your-api-key" }
    }
  }
}

Step 3: Restart Claude Desktop. Alma's 35 tools are now available in every conversation.

What You Can Do

Memory tools: alma_remember, alma_recall, alma_search, alma_extract — save and retrieve information across conversations. Your AI remembers your preferences, project decisions, and personal context.

Context assembly: alma_assemble builds a complete context prompt from your memories, episodes, and soul blocks. The AI gets your full cognitive profile in every conversation without you repeating anything.

Soul management: alma_update_block lets you configure personality, expertise, communication style, and rules that persist across all conversations. This is not a one-time system prompt — it is a structured identity that evolves as you use it.

Code workspaces: Upload repos, browse files, and use 8 AI skills (explain, refactor, review, test, fix, document, search, commit) with full project context.

Works With Any Plan

The MCP server works on all Alma plans including free. Your plan determines memory limits (500 on free, 10K on Pro, unlimited on Ultimate) and weekly budget. The MCP itself has no additional restrictions.

Get Started Free