MCP Server#

Connect your LLMs to persistent memory 🔗🧠

The Model Context Protocol (MCP) server for Memof.ai. Give Claude, GPT-4, and other LLMs the power to remember across conversations.

What is MCP?#

MCP is an open standard for connecting AI applications to external data. Our server acts as a bridge between LLMs and the Memof.ai platform.

Think of it as USB-C for AI memory 🔌

Why MCP Server?#

• 🤖 LLM-Native - Built for Claude, GPT-4, and more
• 🔒 Secure - Token-based authentication
• ⚡ Production-Ready - Battle-tested and reliable
• 🎯 Easy Setup - Working in minutes
• 🛠️ Full-Featured - All Memof.ai features available

Quick Links#

• Installation - Get started
• Claude Integration - Set up with Claude Desktop
• Available Tools - What you can do

60-Second Setup#

For the impatient (we respect that) ⚡

# 1. Clone and install
git clone https://github.com/memof-ai/memofai-mcp-server.git
cd memofai-mcp-server
npm install && npm run build

# 2. Set your API token
export MEMOFAI_API_TOKEN="moa_your_token_here"

# 3. Test it
npx @modelcontextprotocol/inspector node dist/index.js

Claude Desktop Integration#

The most popular setup 💜

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "memofai": {
      "command": "node",
      "args": ["/path/to/memofai-mcp-server/dist/index.js"],
      "env": {
        "MEMOFAI_API_TOKEN": "moa_your_token_here",
        "MEMOFAI_ENVIRONMENT": "production"
      }
    }
  }
}

Restart Claude Desktop. Look for the 🔌 icon. Done!

What Can It Do?#

Workspace Management#

Bot Operations#

Memory Magic#

Available Tools#

All your favorite Memof.ai operations:

• memofai_create_workspace - Create workspaces
• memofai_list_workspaces - List workspaces
• memofai_create_bot - Create bots
• memofai_list_bots - List bots
• memofai_store_memory - Store memories
• memofai_search_memories - Search (the fun one!)
• memofai_list_memories - List all memories

See full tool documentation →

Testing Your Setup#

Use the MCP Inspector:

npm install -g @modelcontextprotocol/inspector
npx @modelcontextprotocol/inspector node dist/index.js

Opens a web UI where you can test all tools. No LLM required!

Environment Variables#

# Required
export MEMOFAI_API_TOKEN="moa_your_token_here"

# Optional
export MEMOFAI_ENVIRONMENT="production"  # or dev, alpha, beta, sandbox

Example Conversations#

With Claude Desktop#

You: "Create a workspace for customer support bots"

Claude: Uses memofai_create_workspace tool ✅
"I've created a workspace called 'Customer Support' with ID ws_123456789"

You: "Create a bot in that workspace"

Claude: Uses memofai_create_bot tool ✅
"Created 'Support Bot' in the Customer Support workspace"

You: "Remember that Sarah from TechCorp prefers phone calls"

Claude: Uses memofai_store_memory tool ✅
"I'll remember that Sarah from TechCorp prefers phone calls"

You: "What do you know about TechCorp?"

Claude: Uses memofai_search_memories tool 🔍
"I found that Sarah from TechCorp prefers phone calls..."

Supported LLMs#

Works with any MCP-compatible client:

• ✅ Claude Desktop
• ✅ Claude API
• ✅ Custom MCP clients
• ✅ Future MCP-compatible LLMs

What's Next?#

Ready to connect?

1. Installation Guide - Detailed setup
2. Claude Integration - Step-by-step
3. Available Tools - Full reference

Features#

• 🧠 Memory Management
• 📁 Workspace Organization
• 🤖 Bot Configuration
• 🔍 Semantic Search
• 🔒 Secure Authentication
• ⚡ Production Ready

Package Info#

{
  "name": "@memofai/mcp-server",
  "version": "latest",
  "license": "MIT",
  "homepage": "https://memof.ai"
}

Need Help?#

• 📖 Full Documentation
• 🐛 GitHub Issues
• 💬 support@memof.ai
• ⭐ Star us!

Give your LLM a memory. It'll thank you later! 🤖💭