@combinedmemory/mcp

MCP Server for Combined Memory API - Connect Claude Desktop (or any MCP client) to your Combined Memory account for AI-powered chat with unlimited context, memory management, voice agents, and 500+ tool integrations.

🚀 Quick Start

Installation

npx @combinedmemory/mcp

Claude Desktop Setup

1. Open Claude Desktop settings
2. Navigate to Settings > Developer
3. Edit claude_desktop_config.json:

{
  "mcpServers": {
    "combined-memory": {
      "command": "npx",
      "args": [
        "-y",
        "@combinedmemory/mcp@latest"
      ],
      "env": {
        "COMBINED_MEMORY_JWT_TOKEN": "your-jwt-token-here"
      }
    }
  }
}

4. Get your JWT token:

curl -X POST https://chat.combinedmemory.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "password": "your-password"}'

5. Copy the token from the response and paste it into the config above
6. Restart Claude Desktop
7. Look for the 🔨 hammer icon in the chat input

📚 Available Tools

Once configured, you'll have access to 30+ API tools:

🔐 Authentication

• auth_login - User login
• auth_register - Create account
• auth_refresh - Refresh token
• auth_logout - Logout

💬 Conversations

• conversations_list - Get all conversations
• conversations_create - Create new conversation
• conversations_get - Get conversation details
• conversations_update - Update conversation
• conversations_delete - Delete conversation

📨 Messages

• messages_send - Send message with SSE streaming

🤖 Agents

• agents_list - List all custom agents
• agents_create - Create AI agent
• agents_get - Get agent details
• agents_update - Update agent
• agents_delete - Delete agent
• agents_duplicate - Duplicate agent
• agents_categories - Get agent categories

🧠 Memory Management

• memories_list - Get all memories
• memories_create - Create memory
• memories_search - Search memories (semantic)
• memories_update - Update memory
• memories_delete - Delete memory
• memories_sync - Sync from Supermemory

🔧 MCP Integration

• mcp_servers_list - List available MCP servers
• mcp_tool_execute - Execute MCP tool

🎤 LiveKit Voice

• livekit_token_generate - Generate voice session token

📎 Files

• files_upload - Upload file (PDF, image, document)

💬 iMessage

• imessage_reply - Generate AI reply with memory context
• imessage_send - Send message via Pushcut
• imessage_allowed_contacts_get - Get whitelist
• imessage_allowed_contacts_add - Add to whitelist
• imessage_allowed_contacts_remove - Remove from whitelist

⚙️ System

• config_get - Get public configuration
• health_check - Check API health

🎯 Example Use Cases

Create a Conversation and Chat

User: "Create a new GPT-4 conversation and ask it about quantum computing"

Claude (using MCP tools):
1. conversations_create(endpoint: "openAI", model: "gpt-4")
2. messages_send(conversationId: "...", text: "Explain quantum computing")
3. Returns the AI response

Search and Manage Memories

User: "Search my memories for anything about the LibreChat project"

Claude:
1. memories_search(q: "LibreChat")
2. Returns relevant memories with semantic matching

Build a Custom Agent

User: "Create an agent that helps with code reviews"

Claude:
1. agents_create(
     name: "Code Reviewer",
     description: "Reviews code for best practices",
     model: "gpt-4",
     instructions: "You are an expert code reviewer..."
   )

🔧 Configuration

Environment Variables

You can customize the MCP server with these environment variables:

• COMBINED_MEMORY_JWT_TOKEN - Your JWT token (required)
• TARGET_API_BASE_URL - API base URL (default: https://chat.combinedmemory.com)
• CUSTOM_HEADERS - Additional headers as JSON string

Advanced Configuration

Create a custom config file:

{
  "spec": "./specs/combined-memory-api.json",
  "targetUrl": "https://chat.combinedmemory.com",
  "headers": {
    "Content-Type": "application/json",
    "X-Custom-Header": "value"
  },
  "securitySchemeName": "BearerAuth"
}

Then run:

npx @combinedmemory/mcp --config /path/to/config.json

🌟 Features

Unlimited Context

All AI endpoints use Supermemory Memory Router for unlimited conversation context - no token limits!

Voice Agents

Access LiveKit voice agents with OpenAI Realtime API integration (STT + LLM + TTS in one pipeline).

500+ Tool Integrations

Through MCP servers: Railway, Webflow, Notion, GitHub, Airtop Browser, and more.

Memory Management

• MongoDB storage with MeiliSearch indexing
• Semantic search across all memories
• Supermemory Cloud sync
• Per-user memory isolation

Multi-Model Support

• OpenAI (GPT-4, GPT-4 Turbo, GPT-3.5)
• Anthropic (Claude 3.5 Sonnet, Claude 3 Opus)
• Google (Gemini 2.0 Flash, Gemini 1.5 Pro)
• Mistral, Groq, Perplexity, OpenRouter
• GitHub Models, Vercel AI, DeepSeek

🔒 Security

• JWT Authentication - Secure token-based auth
• Bearer Token - Industry-standard authorization
• Rate Limiting - 20 req/min for messages, 100 req/min for other endpoints
• HTTPS Only - All API calls encrypted
• Token Refresh - Auto-refresh expired tokens

📖 Documentation

• API Docs: https://chat.combinedmemory.com/api-docs/
• OpenAPI Spec: Bundled in this package at specs/combined-memory-api.json
• MCP Protocol: https://modelcontextprotocol.io

🛠️ Development

Local Development

# Clone the repo
git clone https://github.com/quinnbmay/combined-memory-mcp.git
cd combined-memory-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
npm start

# Development mode
npm run dev

Testing

# Run tests
npm test

# Integration tests
npm run test:integration

📦 Publishing

This package is automatically published to npm when you push a git tag:

# Update version
npm version 1.0.1

# Push tag
git push --tags

GitHub Actions will build and publish to npm.

🙋 Support

• Issues: https://github.com/quinnbmay/combined-memory-mcp/issues
• Email: [email protected]
• Website: https://combinedmemory.com

📄 License

MIT License - See LICENSE file for details

Built on api-to-mcp by Tyk Technologies