mcp-server-emojikey

MCP server for persisting LLM relationship context as emoji-based memory keys. This allows Claude to maintain consistent interaction styles and remember relationship context across conversations.

Emojikeys are stored online, so you can use them across devices and applications. No user information is stored other than the emojikeys.

Building and Running

There are multiple ways to build and run the server:

Quick Start (Recommended)

# Install dependencies
npm install

# Build the project (all TypeScript errors fixed)
npm run build

# Run the server (coding features disabled by default)
npm run start

# Optional: Run with coding features enabled
CODE_MODE=true npm run start

Alternative Build Options

For more build options, see BUILD_OPTIONS.md which includes:

1. Standard Build with Coding Features Disabled (recommended)
2. Full Build with All Features (if you need coding dimensions)
3. Simplified Build without Coding Files (alternative stable option)

📝 Note Usage note: The first time you use the tool in Claude desktop, tell Claude to “Set emojikey” then next time you start a conversation, he will automatically use this key. You can ask to set vibe, or show emojikey history as well. Have fun!

⚠️ Warning This is a beta version, more features are planned, so the API may change.

Usage with Claude Desktop

Get your API key from emojikey.io and add this to your config:

{
  "mcpServers": {
    "emojikey": {
      "command": "npx",
      "args": ["-y", "@identimoji/mcp-server-emojikey"],
      "env": {
        "EMOJIKEYIO_API_KEY": "your-api-key-from-emojikey.io",
        "MODEL_ID": "Claude-3-7-Sonnet",
        "CODE_MODE": "false" // Set to "true" to enable coding features
      }
    }
  }
}

Note: The -y flag in the args array tells npx to skip confirmation prompts when installing packages.

Config locations:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

First-time usage: Tell Claude to “Set emojikey”. On subsequent conversations, Claude will automatically use this key to maintain context.

Emojikey Initialization Display

When initializing a conversation, the server now displays:

1. Starting Key - The most recent key or baseline key if no history exists
2. Aggregated Keys - Time-based summaries of your emojikey history:
   • Lifetime - Aggregated key from all your previous conversations
   • 90-day - Aggregated key from the past 90 days (if available)