Skip to main content
Glama

What is this?

This MCP server connects your AI assistant to Memphora, giving it the ability to:

  • Remember information across conversations

  • Search your personal knowledge base

  • Extract insights from conversations automatically

  • Recall your preferences, facts, and context

Related MCP server: AGI MCP Server

Quick Start

1. Install

# Using pip
pip install memphora-mcp

# Or using uvx (recommended for Claude Desktop)
uvx memphora-mcp

2. Get Your API Key

  1. Go to memphora.ai/dashboard

  2. Create an account or sign in

  3. Copy your API key from the dashboard

3. Configure Claude Desktop

Add to your Claude Desktop config file:

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

{
  "mcpServers": {
    "memphora": {
      "command": "uvx",
      "args": ["memphora-mcp"],
      "env": {
        "MEMPHORA_API_KEY": "your_api_key_here",
        "MEMPHORA_USER_ID": "your_unique_user_id"
      }
    }
  }
}

4. Restart Claude Desktop

Close and reopen Claude Desktop. You should see the Memphora tools available!

Usage Examples

Storing Memories

Just tell Claude something about yourself:

You: "I work at Google as a software engineer"
Claude: [stores memory] "Got it! I'll remember that you work at Google as a software engineer."

You: "My favorite programming language is Python"
Claude: [stores memory] "Noted! I'll remember that Python is your favorite programming language."

Recalling Memories

Ask Claude about things you've told it before:

You: "Where do I work?"
Claude: [searches memories] "You work at Google as a software engineer."

You: "What programming languages do I like?"
Claude: [searches memories] "Your favorite programming language is Python."

Automatic Context

Claude will automatically search your memories when relevant:

You: "Can you help me with some code?"
Claude: [searches memories for context]
        "Sure! Since you prefer Python and work at Google, I'll write this in Python 
         following Google's style guide..."

Available Tools

Tool

Description

memphora_search

Search memories for relevant information

memphora_store

Store new information for future recall

memphora_extract_conversation

Extract memories from a conversation

memphora_list_memories

List all stored memories

memphora_delete

Delete a specific memory

Configuration Options

Environment Variable

Description

Default

MEMPHORA_API_KEY

Your Memphora API key

Required

MEMPHORA_USER_ID

Unique identifier for your memories

mcp_default_user

Using with Other MCP Clients

Cursor

Add to your Cursor settings:

{
  "mcp": {
    "servers": {
      "memphora": {
        "command": "uvx",
        "args": ["memphora-mcp"],
        "env": {
          "MEMPHORA_API_KEY": "your_api_key_here"
        }
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "memphora": {
      "command": "python",
      "args": ["-m", "memphora_mcp"],
      "env": {
        "MEMPHORA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Development

Running Locally

# Clone the repo
git clone https://github.com/Memphora/memphora-mcp.git
cd memphora-mcp

# Install dependencies
pip install -e ".[dev]"

# Set your API key
export MEMPHORA_API_KEY="your_key"

# Run the server
python -m memphora_mcp

Testing

pytest tests/

Privacy & Security

  • Your memories are stored securely in Memphora's cloud

  • Each user has isolated memory storage

  • API keys are stored locally on your machine

  • All communication is encrypted via HTTPS

Support

License

MIT License - see LICENSE for details.

Available Tools

5 tools
memphora_deleteA

Delete a specific memory by its ID. Use this when the user wants to forget something or correct incorrect information.

Inputs: memory_id (required).

memphora_extract_conversationB

Extract and store memories from a conversation. Use this to save important information from a longer discussion. The system will automatically identify and store relevant facts.

Inputs: conversation (required).

memphora_list_memoriesB

List all stored memories for the user. Use this to see what information has been remembered.

Inputs: limit.

memphora_storeA

Store important information about the user for future recall. Use this when the user shares personal details, preferences, facts about themselves, or explicitly asks you to remember something. Examples: 'I work at Google', 'My favorite color is blue', 'Remember that I'm allergic to peanuts'

Inputs: content (required), category.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: delete removes memories, extract processes conversations, list shows all memories, search finds specific memories, and store adds new memories. The descriptions reinforce these distinct roles, making misselection unlikely.

    Naming Consistency5/5

    All tools follow a consistent 'memphora_verb_noun' pattern (e.g., memphora_delete, memphora_extract_conversation). This uniform naming convention makes the tool set predictable and easy to understand at a glance.

    Tool Count5/5

    With 5 tools, this server is well-scoped for a memory management system. Each tool earns its place by covering core operations (store, search, list, delete, and conversation extraction), avoiding bloat while providing complete functionality.

    Completeness5/5

    The tool set offers complete CRUD/lifecycle coverage for the memory domain: store (create), search and list (read), delete (delete), and extract_conversation (a specialized create/update). There are no obvious gaps, enabling agents to handle all expected workflows without dead ends.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to store and retrieve persistent memories with a web management interface. Supports creating, searching, and managing memories through natural language commands or a visual web dashboard.
      1
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Enables persistent memory for AI systems by providing tools for episodic, semantic, and procedural data storage through a vector-and-graph-enhanced database. It allows models to maintain long-term continuity using similarity search, thematic clustering, and identity tracking.
      24
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides persistent memory capabilities for AI assistants, enabling storage, recall, and analysis of information across conversations with intelligent memory management.
      25
      37 npm
      MIT