coladapo/purmemo-mcp

Purmemo MCP Server

Official Model Context Protocol (MCP) server for Purmemo - Your AI-powered second brain with 94% memory retrieval accuracy.

🚀 Never lose a thought again - Purmemo remembers everything so you can focus on what matters.

✨ Features

• 🧠 Smart Memory Storage - AI understands context, not just keywords
• 🔍 Natural Language Search - "What did I learn about React hooks last month?"
• 📎 Rich Attachments - Files, images, links with automatic metadata
• 🏷️ Automatic Entity Extraction - People, places, topics, dates without manual tagging
• ⚡ Lightning Fast - <50ms average retrieval time
• 🔐 Enterprise Security - OAuth 2.1 + PKCE, end-to-end encryption

🚀 Quick Start

1. Create Your Purmemo Account

1. Sign up at purmemo.ai/register
2. Verify your email
3. Sign in to your account

For Option B (Local) only: Get an API key from purmemo.ai/settings → API Keys tab

2. Choose Your Connection Method

3. Configure Claude Desktop

Option A: Remote Connection via Custom Connector (Beta)

1. In Claude Desktop, scroll to bottom of connectors list
2. Click "Add custom connector (BETA)"
3. Enter:
   • Name: Purmemo
   • Remote MCP server URL: https://mcp.purmemo.ai
4. Click "Connect"
5. You'll be redirected to Purmemo login in your browser
6. Sign in with your Purmemo account
7. Authorize Claude to access your memories
8. Return to Claude Desktop - connection established

Option B: Local Connection via Config File

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "purmemo": {
      "command": "npx",
      "args": ["purmemo-mcp"],
      "env": {
        "PURMEMO_API_KEY": "your-api-key-here"
      }
    }
  }
}

4. Start Using in Claude

You: "Remember that the meeting with Sarah is at 3pm tomorrow about the API redesign"
Claude: "I've stored that memory with entities: Sarah (person), 3pm tomorrow (time), API redesign (topic)"

You: "What meetings do I have with Sarah?"
Claude: "Based on your memories: Tomorrow at 3pm - API redesign discussion"

🛠️ Available MCP Tools

v8.0.0 Tools (Local Connection)

save_conversation

Save complete conversations with full context (handles 100K+ characters)

save_conversation(content: string): MemoryResponse

save_with_artifacts

Save content with code artifacts and attachments preserved

save_with_artifacts(content: string, artifacts: object[]): MemoryResponse

recall_memories

Search and retrieve memories using natural language

recall_memories(query: string, limit?: number): Memory[]

get_memory_details

Get detailed information about a specific memory

get_memory_details(memory_id: string): Memory

Tools Available in Both Connections

Once the remote server update is complete, both connection methods will provide the same v8.0.0 tools with complete conversation capture, auto-chunking for 100K+ characters, and artifact preservation.

🎯 Real-World Use Cases

For Developers

"Remember the Redis cache config: max-memory 2gb, eviction policy LRU, persistence AOF"
"What were those PostgreSQL optimization tips from last week's debugging session?"
"Show me all the API endpoints I've documented this month"

For Researchers

"Store this paper: [arxiv link] - key insight about transformer attention mechanisms"
"What connections exist between my notes on neural networks and optimization?"
"Find all memories related to machine learning from Q3 2024"

For Project Managers

"Remember stakeholder feedback: John wants faster load times, prioritize performance"
"What were the action items from yesterday's standup?"
"Show me all decisions made about the Q4 roadmap"

🔒 Security & Privacy

• API Key Authentication: Secure token-based access control
• HTTPS/TLS Encryption: All data encrypted in transit
• Data Privacy: Your memories belong to you
• Account Control: Delete your data anytime from settings

💰 Pricing

Free Tier

• 50 memories/month
• Basic search
• Full MCP integration
• Community support

Pro ($9/month)

• Unlimited memories
• Advanced AI features
• Priority support
• API access

Teams ($29/month)

• Unlimited memories for 5 users
• Shared knowledge base
• Team collaboration features
• Admin dashboard
• Priority support

🔧 Development

Local Development

# Clone the repository
git clone https://github.com/coladapo/purmemo-mcp.git
cd purmemo-mcp

# Install dependencies
npm install

# Run tests
npm test

# Start local server
PURMEMO_API_KEY=your-key npm start

Contributing

We welcome contributions to the MCP protocol implementation! Please note:

• This repository contains only the open-source MCP wrapper
• Core memory algorithms remain proprietary
• See for guidelines

📚 Documentation

• API Documentation
• MCP Integration Guide
• Security Whitepaper
• Terms of Service

🎖️ Recognition

Purmemo MCP is pursuing official recognition in the Model Context Protocol servers repository.

📄 License

MIT License - See file

🆘 Support

• 📧 Email: support@purmemo.ai
• 🐛 Issues: GitHub Issues
• 🌐 Website: purmemo.ai