AI Memory MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@AI Memory MCP Serverremember that I prefer using React with Tailwind for my web projects"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
AI Memory MCP Server
A cross-platform Model Context Protocol (MCP) server that provides persistent memory storage for AI assistants. This server allows AI models to store, retrieve, and manage memories across conversations.
Features
Persistent Storage: Memories are stored in a JSON file and survive server restarts
Rich Memory Management: Store memories with content, tags, and custom metadata
Powerful Search: Search memories by keywords or filter by tags
Cross-Platform: Works on Windows, macOS, and Linux
Easy Integration: Compatible with any MCP client (Claude Desktop, etc.)
Related MCP server: Local Brain MCP
Installation
Prerequisites
Node.js 18.0.0 or higher
Setup
Clone or download this repository
Install dependencies:
npm installUsage
Running the Server
npm startFor development with auto-reload:
npm run devConfiguration
Claude Desktop
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": {
"ai-memory": {
"command": "node",
"args": ["/absolute/path/to/mcp_server/index.js"]
}
}
}Other MCP Clients
Use the stdio transport and point to the index.js file:
node /path/to/mcp_server/index.jsAvailable Tools
1. store_memory
Store a new memory or piece of knowledge.
Parameters:
content(required): The content to remembertags(optional): Array of tags to categorize the memorymetadata(optional): Additional metadata as key-value pairs
Example:
{
"content": "User prefers dark mode UI",
"tags": ["preferences", "ui"],
"metadata": {
"priority": "high"
}
}2. search_memories
Search through stored memories using keywords or tags.
Parameters:
query(optional): Search query (searches in content)tags(optional): Filter by specific tagslimit(optional): Maximum number of results (default: 10)
Example:
{
"query": "dark mode",
"tags": ["preferences"],
"limit": 5
}3. list_memories
List all stored memories with optional filtering.
Parameters:
tags(optional): Filter by specific tagslimit(optional): Maximum number of results (default: 50)
4. delete_memory
Delete a specific memory by its ID.
Parameters:
id(required): The ID of the memory to delete
5. clear_memories
Clear all stored memories. Use with caution!
Parameters:
confirm(required): Must be set totrueto confirm deletion
6. get_memory_stats
Get statistics about stored memories (total count, tags, etc.).
Returns: Statistics including total count, tag counts, and timestamps.
Available Resources
memory://all
Complete list of all stored memories in JSON format.
memory://stats
Statistics about stored memories including counts and tag distribution.
Data Storage
Memories are stored in memories.json in the server directory. Each memory has:
id: Unique identifiercontent: The memory contenttags: Array of tagsmetadata: Custom metadata objecttimestamp: ISO 8601 timestamp of when the memory was created
Example Use Cases
User Preferences: Store user preferences that persist across conversations
Project Context: Remember project details, architecture decisions, and requirements
Learning: Store facts and knowledge the AI should remember
Task Tracking: Keep track of ongoing tasks and their status
Conversation History: Store important points from previous conversations
Security Notes
The memory file is stored locally on the machine running the server
No data is sent to external services
Ensure proper file permissions on the
memories.jsonfileBack up the
memories.jsonfile regularly if you store important information
Troubleshooting
Server won't start
Ensure Node.js 18+ is installed:
node --versionCheck that dependencies are installed:
npm installVerify file permissions on the server directory
Memories not persisting
Check write permissions on the server directory
Ensure the server process isn't being killed before writes complete
Check for errors in the console output
Can't connect from Claude Desktop
Verify the path in the configuration is absolute, not relative
Check that the configuration JSON is valid
Restart Claude Desktop after changing the configuration
Check Claude Desktop logs for connection errors
Platform-Specific Notes
Windows
Use forward slashes or escaped backslashes in the config path
Example:
C:/Users/YourName/mcp_server/index.jsorC:\\Users\\YourName\\mcp_server\\index.js
macOS/Linux
Ensure the index.js file has execute permissions:
chmod +x index.jsUse absolute paths starting with
/or~
License
MIT
Contributing
Contributions are welcome! Please feel free to submit issues or pull requests.
Support
For issues and questions, please open an issue on the GitHub repository.
Available Tools
6 toolsclear_memoriesA
Clear all stored memories. Use with caution as this cannot be undone.
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | Yes | Must be set to true to confirm deletion |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It effectively communicates the destructive nature ('cannot be undone') and the need for caution, which are critical for a mutation tool. However, it lacks details on permissions, rate limits, or error conditions that would further inform usage.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise with two sentences that are front-loaded and zero waste. The first sentence states the purpose, and the second adds crucial behavioral context, making every word earn its place without redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (destructive operation with no annotations and no output schema), the description is adequate but has gaps. It covers the irreversible nature but lacks details on what 'memories' entail, confirmation mechanics beyond the schema, or expected outcomes, leaving some contextual information incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, with the 'confirm' parameter fully documented in the schema. The description does not add any additional meaning or context about parameters beyond what the schema provides, so it meets the baseline score of 3 for high schema coverage.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the specific action ('Clear') and resource ('all stored memories'), distinguishing it from siblings like delete_memory (which targets individual memories) and list_memories (which is read-only). It precisely defines the scope as 'all' rather than selective deletion.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context with 'Use with caution as this cannot be undone,' indicating high-risk scenarios. However, it does not explicitly mention when to use alternatives like delete_memory for targeted removal or list_memories for verification, leaving some guidance implicit rather than explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_memoryC
Delete a specific memory by its ID.
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ID of the memory to delete |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden but only states the action ('Delete') without disclosing critical behavioral traits. It doesn't mention whether deletion is permanent, requires specific permissions, has side effects, or returns confirmation. For a destructive operation, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with zero wasted words. It's appropriately sized for a simple tool and front-loads the essential action and resource.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a destructive tool with no annotations and no output schema, the description is incomplete. It doesn't address behavioral risks, return values, or differentiation from siblings. Given the complexity of deletion operations, more context is needed.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds minimal value beyond the input schema, which has 100% coverage and fully documents the single parameter 'id'. The description restates that an ID is needed but doesn't provide additional context like ID format or sourcing.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Delete') and resource ('a specific memory by its ID'), making the purpose unambiguous. However, it doesn't differentiate from sibling tools like 'clear_memories' (which likely deletes multiple memories) or explain what constitutes a 'memory' in this context.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like 'clear_memories' or 'store_memory'. It lacks context about prerequisites (e.g., needing an existing memory ID) or exclusions (e.g., not for bulk deletion).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_memory_statsB
Get statistics about stored memories (total count, tags, etc.)
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool retrieves statistics, implying a read-only operation, but doesn't specify whether this requires authentication, has rate limits, or details about the return format (e.g., structure of the statistics). The mention of 'tags, etc.' hints at additional data but lacks concrete behavioral traits like performance implications or error conditions.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that directly states the tool's function without unnecessary words. It's front-loaded with the core purpose and includes helpful examples ('total count, tags, etc.') that add value. However, it could be slightly more structured by explicitly separating purpose from usage context.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's low complexity (0 parameters, no output schema, no annotations), the description is minimally adequate. It covers the basic purpose but lacks details on behavioral aspects like authentication or return format, which are important even for simple tools. With no output schema, the description doesn't explain what 'statistics' entail, leaving gaps in completeness for agent invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has 0 parameters, and schema description coverage is 100%, so there's no need for parameter documentation in the description. The description appropriately doesn't discuss parameters, focusing instead on the tool's purpose. A baseline of 4 is applied for zero-parameter tools, as no compensation is needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with a specific verb ('Get') and resource ('statistics about stored memories'), including examples of what statistics are returned ('total count, tags, etc.'). It distinguishes from siblings like 'list_memories' or 'search_memories' by focusing on aggregated statistics rather than individual memory retrieval. However, it doesn't explicitly contrast with all siblings (e.g., 'clear_memories' is clearly different, but the distinction from 'list_memories' could be more explicit).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention scenarios where statistical overview is preferred over listing or searching memories, nor does it reference sibling tools like 'list_memories' or 'search_memories' for comparison. There's no indication of prerequisites, timing, or exclusions for usage.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_memoriesC
List all stored memories with optional filtering by tags.
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Filter by specific tags | |
| limit | No | Maximum number of results to return (default: 50) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool lists memories with optional filtering, but doesn't describe what a 'memory' entails, how results are returned (e.g., pagination, format), or any constraints like rate limits or permissions. This leaves significant gaps for an agent to understand the tool's behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that front-loads the core purpose ('List all stored memories') and adds a useful detail ('with optional filtering by tags'). There is no wasted language, making it highly concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of annotations and output schema, the description is incomplete. It doesn't explain what a 'memory' is, how results are structured, or any behavioral traits like default ordering or error handling. For a tool with two parameters and no structured output information, more context is needed to guide an agent effectively.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description mentions optional filtering by tags, which aligns with the 'tags' parameter in the schema. With 100% schema description coverage, the schema already documents both parameters ('tags' and 'limit') clearly. The description adds minimal value beyond the schema, so a baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('List') and resource ('all stored memories'), making the purpose immediately understandable. It distinguishes from siblings like 'search_memories' by specifying 'all stored memories' rather than a search operation, though it doesn't explicitly contrast with other siblings like 'get_memory_stats'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It mentions optional filtering by tags, but doesn't specify when to use 'list_memories' versus 'search_memories' or other siblings, nor does it mention prerequisites or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_memoriesC
Search through stored memories using keywords or tags. Returns relevant memories that match the search criteria.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search query (searches in content) | |
| tags | No | Filter by specific tags | |
| limit | No | Maximum number of results to return (default: 10) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool 'Returns relevant memories that match the search criteria,' which implies a read-only operation, but doesn't cover important aspects like permissions, rate limits, error handling, or what constitutes a 'relevant' match. For a search tool with zero annotation coverage, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise and front-loaded, consisting of two clear sentences: one stating the purpose and one stating the return behavior. There is no wasted text, and every sentence earns its place by providing essential information efficiently.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (a search function with 3 parameters) and the absence of both annotations and an output schema, the description is incomplete. It doesn't explain the return format, how results are ordered, or any limitations (e.g., partial matches, case sensitivity). For a tool with no structured behavioral data, more detail is needed to be fully helpful.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description mentions 'keywords or tags,' which aligns with the 'query' and 'tags' parameters in the schema. However, schema description coverage is 100%, meaning the schema already fully documents all parameters. The description adds minimal value beyond what the schema provides, so it meets the baseline score of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Search through stored memories using keywords or tags.' It specifies the verb ('Search'), resource ('stored memories'), and method ('using keywords or tags'). However, it doesn't explicitly differentiate from sibling tools like 'list_memories' or 'get_memory_stats,' which prevents a perfect score.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention when to prefer 'search_memories' over 'list_memories' or other siblings, nor does it specify prerequisites or exclusions. This lack of contextual direction leaves the agent with minimal usage guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
store_memoryB
Store a new memory or piece of knowledge. Use this to remember important information, facts, preferences, or context for future conversations.
| Name | Required | Description | Default |
|---|---|---|---|
| content | Yes | The content to remember | |
| tags | No | Optional tags to categorize the memory | |
| metadata | No | Optional metadata (key-value pairs) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It mentions that the tool stores information for future use, implying persistence, but fails to describe key behavioral traits such as how memories are stored (e.g., durability, access controls), potential limitations (e.g., storage capacity, rate limits), or what happens on success/failure. This leaves significant gaps for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is appropriately sized with two sentences that are front-loaded with the core purpose. Every sentence earns its place by explaining what the tool does and its intended use, though it could be slightly more structured by separating usage guidelines into a distinct part.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (a mutation tool with no annotations and no output schema), the description is incomplete. It lacks details on behavioral aspects like how memories are stored, any prerequisites (e.g., authentication), or what the tool returns. With no output schema to explain return values, the description should provide more context to be fully helpful.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all three parameters ('content', 'tags', 'metadata') with their types and optionality. The description adds no additional meaning beyond this, such as examples of valid content or metadata usage. Baseline 3 is appropriate when the schema handles parameter documentation effectively.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose with a specific verb ('Store') and resource ('memory or piece of knowledge'), and provides examples of what can be stored ('important information, facts, preferences, or context'). However, it doesn't explicitly differentiate this from sibling tools like 'clear_memories' or 'delete_memory', which prevents a perfect score.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides implied usage guidance by stating 'Use this to remember important information... for future conversations,' which suggests when to use it. However, it lacks explicit guidance on when not to use it or alternatives among the sibling tools, such as when to use 'search_memories' instead for retrieval.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
6 tool updates
- First observed
clear_memories - First observed
delete_memory - First observed
get_memory_stats - First observed
list_memories - First observed
search_memories - First observed
store_memory
TDQS
Each tool has a clearly distinct purpose with no overlap: clear_memories removes all memories, delete_memory targets a specific ID, get_memory_stats provides metadata, list_memories enumerates with filtering, search_memories finds matches based on content, and store_memory adds new data. An agent can easily distinguish between these operations.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., clear_memories, delete_memory, store_memory). The verbs are precise and descriptive, making the set highly predictable and readable.
With 6 tools, the server is well-scoped for an AI memory management system. Each tool serves a distinct role in the memory lifecycle (store, retrieve, search, manage, and analyze), and none feel redundant or missing for the domain.
The toolset provides complete CRUD/lifecycle coverage for memory management: store_memory (create), list_memories/search_memories (read/query), delete_memory (delete), clear_memories (bulk delete), and get_memory_stats (analytics). There are no obvious gaps that would hinder an agent's workflow.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Persistent personal memory for AI assistants — save, search, and recall across every MCP client.
- mcpOAuthai.butlerbrain
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Cloud-hosted MCP server for durable AI memory
Persistent memory for AI agents — log and recall conversation context over MCP.
Related MCP Servers
- AlicenseAqualityCmaintenanceA local, fully-offline MCP memory server that enables persistent storage and retrieval of information using SQLite with both keyword and semantic vector search capabilities.102312MIT
- FlicenseNot gradedqualityDmaintenanceA local MCP server for AI assistants to store and retrieve personal memories on disk, with optional semantic search using embeddings.-
- FlicenseNot gradedqualityDmaintenanceAn MCP server for managing persistent AI memory using hybrid search (keyword + semantic vector) with SQLite storage and offline-first local embeddings.-
- FlicenseAqualityDmaintenanceA lightweight MCP server that provides persistent knowledge graph storage for AI assistants, enabling memory across sessions through entity-relationship storage with JSON file persistence.101-
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Scofieldkoh/mcp_server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server