Give Claude a Memory: Persistent User Context with Apache Unomi

Claude is brilliant, but it forgets everything the moment you close a conversation. Your preferences, project context, user history—gone. For developers building personalized AI experiences, this memory gap is a real problem.

This MCP server solves that by connecting Claude Desktop directly to Apache Unomi, giving your AI assistant a proper Customer Data Platform as its memory system.

The Context Problem

Most AI integrations treat each conversation as isolated events. You've probably experienced this frustration:

• Explaining your coding preferences repeatedly
• Re-establishing project context every session
• Losing track of user-specific customizations
• Managing multiple users without any identification system

Meanwhile, you're building applications that need to remember users, maintain preferences, and provide personalized experiences. Why shouldn't your AI assistant do the same?

Real CDP-Powered Memory

Instead of building another simple key-value store, this server leverages Apache Unomi—a production-ready Customer Data Platform that enterprises use for real user data management.

What you get:

• Email-based user identification across sessions
• Profile property management for persistent preferences
• Automatic session handling with date-based organization
• Scope isolation for different contexts or applications
• Enterprise-grade data management with Apache Unomi's proven architecture

Immediate Use Cases

Personal AI Assistant:

// Claude remembers your coding style preferences
{
  "preferredLanguage": "TypeScript",
  "codingStyle": "functional",
  "testFramework": "vitest",
  "indentation": 2
}

Multi-User Development Team:

• Each team member identified by email
• Individual preferences and project contexts maintained
• Shared scope for team-wide information
• Personal scopes for individual customizations

Client Management:

• Store client preferences and project details
• Maintain conversation history and context
• Track project evolution and decisions
• Seamless handoffs between team members

Simple Integration

Add to your Claude Desktop config and you're running:

{
  "mcpServers": {
    "unomi-server": {
      "command": "npx",
      "args": ["@inoyu/mcp-unomi-server"],
      "env": {
        "UNOMI_BASE_URL": "http://your-unomi-server:8181",
        "UNOMI_EMAIL": "[email protected]",
        "UNOMI_USERNAME": "karaf",
        "UNOMI_PASSWORD": "karaf"
      }
    }
  }
}

The server handles profile resolution automatically—if it finds your email, it uses that profile. Otherwise, it falls back to environment variables. Sessions are created daily with predictable naming (profileId-YYYYMMDD).

Developer-Friendly Architecture

Five focused tools:

1. get_my_profile - Retrieve your complete profile with segments and scores
2. update_my_profile - Modify profile properties with type safety
3. get_profile - Access any profile by ID
4. search_profiles - Query across names and emails
5. create_scope - Manage context isolation

Automatic scope management means you don't babysit infrastructure—the server creates required scopes when needed while letting you customize them for specific use cases.

Built-in debugging with MCP Inspector integration and proper logging to Claude Desktop's log files.

Production Ready

This isn't a proof-of-concept—it's built on Apache Unomi, which handles enterprise-scale customer data. The MCP server includes:

• Proper error handling and fallback mechanisms
• Security through Unomi's authorization system
• CORS configuration guidance for production deployments
• IP-based access controls
• Comprehensive troubleshooting documentation

The Real Value

You're not just adding memory to Claude—you're giving it access to a proper data platform that can grow with your needs. Profile management, event tracking, segmentation, scoring—all the capabilities you'd want in a personalized AI system.

Start with simple preference storage, then expand into sophisticated user behavior tracking and personalization as your requirements evolve.

Ready to give Claude the memory it deserves? The Apache Unomi MCP server is available on npm and ready for your Claude Desktop configuration.