annibale-x avatar

Mcp Memento

annibale-x/mcp-memento

Gives Claude persistent memory across sessions using a local SQLite database. Stores solutions, facts, and context with a confidence scoring system that automatically decays unused knowledge while protecting critical information like auth credentials. Supports 35 relationship types to map connections between concepts, and surfaces them through tools like store_memento, recall_mementos, and create_relationship. Works across Zed, Cursor, VSCode, and CLI tools like Gemini. Ships with three profiles: core for basic operations, extended for power users who need statistics and decay control, and advanced for graph analysis. Reach for this when you want your AI to remember bug fixes, architectural decisions, or project context between sessions without manually copying notes.

GitHub stars
2
tools
17
transport
STDIO
last updated
Mar 21, 2026

Tools

17 tools

Public tool metadata for what this MCP can expose to an agent.

create_entitiesCreate multiple new entities in your Memento MCP knowledge graph memory system1 params

Create multiple new entities in your Memento MCP knowledge graph memory system

Parameters* required
entitiesarray
create_relationsCreate multiple new relations between entities in your Memento MCP knowledge graph memory. Relations should be in active voice1 params

Create multiple new relations between entities in your Memento MCP knowledge graph memory. Relations should be in active voice

Parameters* required
relationsarray
add_observationsAdd new observations to existing entities in your Memento MCP knowledge graph memory4 params

Add new observations to existing entities in your Memento MCP knowledge graph memory

Parameters* required
confidencenumber
Default confidence level (0.0 to 1.0) for all observations
metadataobject
Default metadata for all observations
observationsarray
strengthnumber
Default strength value (0.0 to 1.0) for all observations
delete_entitiesDelete multiple entities and their associated relations from your Memento MCP knowledge graph memory1 params

Delete multiple entities and their associated relations from your Memento MCP knowledge graph memory

Parameters* required
entityNamesarray
An array of entity names to delete
delete_observationsDelete specific observations from entities in your Memento MCP knowledge graph memory1 params

Delete specific observations from entities in your Memento MCP knowledge graph memory

Parameters* required
deletionsarray
delete_relationsDelete multiple relations from your Memento MCP knowledge graph memory1 params

Delete multiple relations from your Memento MCP knowledge graph memory

Parameters* required
relationsarray
An array of relations to delete
get_relationGet a specific relation with its enhanced properties from your Memento MCP knowledge graph memory3 params

Get a specific relation with its enhanced properties from your Memento MCP knowledge graph memory

Parameters* required
fromstring
The name of the entity where the relation starts
relationTypestring
The type of the relation
tostring
The name of the entity where the relation ends
update_relationUpdate an existing relation with enhanced properties in your Memento MCP knowledge graph memory1 params

Update an existing relation with enhanced properties in your Memento MCP knowledge graph memory

Parameters* required
relationobject
read_graphRead the entire Memento MCP knowledge graph memory system1 params

Read the entire Memento MCP knowledge graph memory system

Parameters* required
random_stringstring
Dummy parameter for no-parameter tools
search_nodesSearch for nodes in your Memento MCP knowledge graph memory based on a query1 params

Search for nodes in your Memento MCP knowledge graph memory based on a query

Parameters* required
querystring
The search query to match against entity names, types, and observation content
open_nodesOpen specific nodes in your Memento MCP knowledge graph memory by their names1 params

Open specific nodes in your Memento MCP knowledge graph memory by their names

Parameters* required
namesarray
An array of entity names to retrieve
semantic_searchSearch for entities semantically using vector embeddings and similarity in your Memento MCP knowledge graph memory6 params

Search for entities semantically using vector embeddings and similarity in your Memento MCP knowledge graph memory

Parameters* required
entity_typesarray
Filter results by entity types
hybrid_searchboolean
Whether to combine keyword and semantic search (default: true)
limitnumber
Maximum number of results to return (default: 10)
min_similaritynumber
Minimum similarity threshold from 0.0 to 1.0 (default: 0.6)
querystring
The text query to search for semantically
semantic_weightnumber
Weight of semantic results in hybrid search from 0.0 to 1.0 (default: 0.6)
get_entity_embeddingGet the vector embedding for a specific entity from your Memento MCP knowledge graph memory1 params

Get the vector embedding for a specific entity from your Memento MCP knowledge graph memory

Parameters* required
entity_namestring
The name of the entity to get the embedding for
get_entity_historyGet the version history of an entity from your Memento MCP knowledge graph memory1 params

Get the version history of an entity from your Memento MCP knowledge graph memory

Parameters* required
entityNamestring
The name of the entity to retrieve history for
get_relation_historyGet the version history of a relation from your Memento MCP knowledge graph memory3 params

Get the version history of a relation from your Memento MCP knowledge graph memory

Parameters* required
fromstring
The name of the entity where the relation starts
relationTypestring
The type of the relation
tostring
The name of the entity where the relation ends
get_graph_at_timeGet your Memento MCP knowledge graph memory as it existed at a specific point in time1 params

Get your Memento MCP knowledge graph memory as it existed at a specific point in time

Parameters* required
timestampnumber
The timestamp (in milliseconds since epoch) to query the graph at
get_decayed_graphGet your Memento MCP knowledge graph memory with confidence values decayed based on time2 params

Get your Memento MCP knowledge graph memory with confidence values decayed based on time

Parameters* required
decay_factornumber
Optional decay factor override (normally calculated from half-life)
reference_timenumber
Optional reference timestamp (in milliseconds since epoch) for decay calculation

Sponsors

Readme

MCP Memento

Python Version License MCP Protocol Latest Release Beta

Intelligent memory management for MCP clients with confidence tracking, relationship mapping, and knowledge quality maintenance.

Memento is an MCP server that provides persistent memory capabilities across multiple platforms:

  • IDEs: Zed, Cursor, Windsurf, VSCode, Claude Desktop
  • CLI Agents: Gemini CLI, Claude CLI, custom agents
  • Programmatic Usage: MCP client (Python), Docker deployment, CLI export/import
  • Applications: Any MCP-compatible application

Build a personal or team knowledge base that grows smarter over time, accessible from all your development tools.

Table of Contents


View the full README on GitHub

Details

Repository
github.com/annibale-x/mcp-memento
Category
AI & LLM Tools
Package
mcp-memento
Transport
STDIO
Registry
MCP registry, active

More from annibale-x

Related AI & LLM Tools MCP servers

View all
1eralpozcan avatarVision Squeezereralpozcan/vision-squeezerShrink images to a token budget for vision LLM agents and pipelines. Not for chat-pasted images.2stars
2geiserx avatarLynxPromptgeiserx/lynxprompt-mcpSearch, read and manage AI agent instruction blueprints (AGENTS.md, CLAUDE.md) on LynxPrompt2stars
3im-sham avatarAegis Protocolim-sham/aegis-protocolTrustless escrow for AI agent-to-agent transactions on Base L2 with ERC-8004 identity and USDC.2stars
4alexanderclapp avatarClirankalexanderclapp/clirank-mcp-serverSearch, compare, and get docs for 210+ APIs ranked by CLI and agent relevance.2stars
5cachly-dev avatarcachly — memory for coding agentscachly-dev/cachly-mcpMemory for coding agents: stores every fix and finds it again when the problem returns. EU-hosted.2stars
6clicks-protocol avatarMcp Serverclicks-protocol/clicks-protocolAgent commerce settlement tools on Base: treasury setup, payment splits, yield and attribution.2stars