README.md
MCP server for memory and note management.
Memory MCP Server
MCP (Model Context Protocol) server for memory and note management. Provides tools for AI agents to read, write, and search memories and daily notes.
Features
- Memory Management: Add and search entries in
MEMORY.md(long-term memory) - Daily Notes: Read/write daily notes in
memory/YYYY-MM-DD.md - TODO Lists: Add, list, and complete TODO items
- Context Awareness: Get a summary of current context for AI agents
Installation
cd /root/.openclaw/workspace/memory-mcp-server
npm install
Usage
Start the Server
# Development mode
npm start
# Or run directly
node index.js
Available Tools
| Tool | Description | Arguments |
|---|---|---|
get_memory |
Read MEMORY.md | None |
add_memory |
Add entry to MEMentry(required),category` (optional) |
|
| ORY.md | ` | search_memory |
get_daily_note |
Read a daily note | date (optional, YYYY-MM-DD) |
add_daily_note |
Add to daily note | entry (required), date (optional) |
list_daily_notes |
List available notes | limit (optional, default: 10) |
get_todos |
Get TODOs for a date | date (optional) |
add_todo |
Add a TODO item | todo (required), date (optional) |
complete_todo |
Mark TODO complete | todo (required), date (optional) |
get_context |
Get context summary | None |
Example Usage
// Add a memory
await tools.add_memory({
entry: "User prefers WhatsApp for communication",
category: "Preferences"
});
// Search memories
await tools.search_memory({
query: "WhatsApp"
});
// Add a TODO
await tools.add_todo({
todo: "Fix the Moltbook API timeout issue"
});
// Get context
await tools.get_context();
Integration with mcporter
Add to your MCP configuration:
{
"mcpServers": {
"memory": {
"command": "node",
"args": ["/root/.openclaw/workspace/memory-mcp-server/index.js"],
"disabled": false
}
}
}
File Structure
memory-mcp-server/
├── index.js # Main server implementation
├── package.json # NPM configuration
├── README.md # This file
└── test.js # Test suite
License
ISC
Tools (10)
get_memoryRead MEMORY.mdadd_memoryAdd entry to MEMORY.mdsearch_memorySearch MEMORY.mdget_daily_noteRead a daily noteadd_daily_noteAdd to daily notelist_daily_notesList available notesget_todosGet TODOs for a dateadd_todoAdd a TODO itemcomplete_todoMark TODO completeget_contextGet context summaryConfiguration
claude_desktop_config.json
{"mcpServers": {"memory": {"command": "node", "args": ["/root/.openclaw/workspace/memory-mcp-server/index.js"]}}}Try it
→Add a memory that I prefer using WhatsApp for all my professional communication.
→Search my memories for any notes related to the Moltbook API.
→Add a new TODO item to fix the API timeout issue for today.
→What is the current context summary for my project?
→List my daily notes from the last 5 days.