Epitome Personal Portable AI Memory Vault

by gunning4it

266 downloads

Not rated

GitHub

About

Epitome gives every AI agent shared, persistent memory of you. It stores memories, facts, and preferences in a personal knowledge graph, so any AI tool you use already knows your context. Connect via MCP using Streamable HTTP — no local install needed.

Details

Author: gunning4it
Downloads: 266
Categories: Database, Knowledge Base, AI

- Knowledge graph — entities and relationships extracted automatically from every interaction
- Semantic search — vector-powered memory recall across all saved content
- Structured data — track anything with auto-created tables and columns
- Contradiction detection — automatic quality checks keep memory accurate
- Per-user isolation — each user gets their own PostgreSQL schema

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Epitome Personal Portable AI Memory Vault

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

From the repository

Configure an MCP client with a streamable-http transport pointing to https://epitome.fyi/mcp and an API key in the authorization header. Obtain your API key from https://epitome.fyi/dashboard/settings. After setup, invoke any of the nine provided tools (e.g., get_user_context at conversation start, save_memory to store notes).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "epitome   personal portable ai memory vault": {
            "epitome": {
                "type": "streamable-http",
                "url": "https://epitome.fyi/mcp",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "epitome": {
        "type": "streamable-http",
        "url": "https://epitome.fyi/mcp",
        "headers": {
            "Authorization": "Bearer <YOUR_API_KEY>"
        }
    }
}

- Recall what your AI assistant knows about you— ask the assistant to retrieve stored facts, preferences, or context using therecalltool.
- Save new information to your shared memory— tell the assistant to persist a preference, fact, or detail about you via thememorizetool.
- Review and audit stored memories— request a summary or inspection of what’s been saved and which agents have accessed it using thereviewtool.

The portable identity layer that gives every AI agent a shared, persistent memory of you.
Open source. Self-hostable. Yours.

Website·Quickstart·Connect an Agent·Docs·Contributing

Every AI conversation starts from zero. You repeat yourself to every agent — your name, your preferences, your allergies, your tech stack. Chat history is siloed per app. There's no portable memory layer.

Epitome fixes this.One database that every AI agent shares, so they all remember you.
- Sign up at epitome.fyi
- Go toSettings → API Keysand copy your MCP URL
- Connect an AI agent— done

git clone https://github.com/gunning4it/epitome.git cd epitome cp .env.example .env # edit with your credentials docker compose up -d

Get your API key fromSettings → API Keysin the dashboard (hosted or self-hosted).

Add to yourclaude_desktop_config.json:

{ "mcpServers": { "epitome": { "url": "https://epitome.fyi/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

claude mcp add --transport http --header "Authorization: Bearer YOUR_API_KEY" epitome https://epitome.fyi/mcp

For self-hosted, replacehttps://epitome.fyiwithhttp://localhost:3000.

Epitome exposes3 MCP tools— recall, memorize, and review. See the full tool reference.

- AI developersbuilding agents that need persistent user memory
- Power userswho want every AI to remember them across platforms
- Self-hosterswho want full data ownership — no cloud required

- Your meal-tracking agent remembers your allergies
- Your coding assistant knows your stack, your patterns, your team
- Your calendar agent knows your family, your priorities, your routines
- Every new AI tool you try already knows you on day one

AI Agent ──→ MCP (Streamable HTTP) ──→ Hono API ──→ PostgreSQL │ per-user schema isolation

Each user gets their own PostgreSQL schema (user_{id}) — not row-level security, full schema-level isolation. Cross-schema access is impossible at the SQL level.

See EPITOME_TECH_SPEC.mdfor the full architecture.

- You own your data— self-host or use the hosted service
- Per-user PostgreSQL schema isolation— not row-level security, full schema separation
- Per-agent consent rules— you control what each agent can read and write
- Append-only audit log— every access is recorded
- GDPR-ready— export or delete all your data at any time

- Quick Start— Get running in minutes
- JavaScript SDK— Build with@epitomefyi/sdk
- npm Package— Install and version history
- AI SDK Tools—searchMemory,saveMemory,getUserContextfor tool-calling
- API Reference— REST endpoint documentation
- MCP Tools— All 3 MCP tools explained
- Architecture— Full technical specification
- Data Model— Every table, column, and constraint
- Self-Hosting Guide— Docker Compose deployment
- Security— Isolation, consent, and audit

Contributions are welcome! See CONTRIBUTING.mdfor guidelines.

git clone https://github.com/gunning4it/epitome.git cd epitome && cp .env.example .env docker compose up -d

Then open a PR — we're happy to help with your first contribution.

Official Airtable MCP server and skills for working with bases, records, workflows, and business operations from AI agents.

MCP Server For Apache Doris, an MPP-based real-time data warehouse.

Official MCP Server from Atlan which enables you to bring the power of metadata to your AI tools

Query Onchain data, like ERC20 tokens, transaction history, smart contract state.

Read and write access to your Baserow tables.

Introspect and query your apps deployed to Convex.

Interact with the data stored in Couchbase clusters using natural language.

Maritime intelligence for tracking vessels, analysing ports, and exploring ship data.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Aws Kb Retrieval Server

Redis

Memory

Sqlite

PostgreSQL

Context 7