MCP Server Memo
About
A lightweight MCP server for session memory management
Details
- License
- MIT license
Explore
- Preserves all historical versions of each session summary.
- Sessions are time-ordered for easy tracking of conversation development.
- Stores data on the local filesystem without requiring an external database.
- Complies with the Model Context Protocol to provide MCP tool interfaces.
- Optimized for file I/O and concurrent operations.
- Minimal dependencies for easy maintenance and extension.
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
MCP Server MemoCommand (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
From the repository
Clone the repository from GitHub, run npm install and npm build. Configure the storage directory via the MCP_SUMMARY_DIR environment variable (defaults to ./summaries/). Start the server with npm start or npm run dev for auto-reload. Clients connect using the MCP SDK and call tools like upsertSummary, getSummaryTool, listSummariesTool, appendSummary, getSessionHistory, and updateMetadata.
sessionId
(string, required): The unique ID of the session summary to retrieve.
maxLength
(number, optional): If provided, truncate the retrieved summary text to this maximum length.
tag
(string, optional): Filter sessions by a specific tag.
limit
(number, optional): Limit results.
offset
(number, optional): Offset for pagination.
sortBy
(string, optional): Sort field ('lastUpdated' or 'title'). Default: 'lastUpdated'.
order
(string, optional): Sort order ('asc' or 'desc'). Default: 'desc'.
The server provides the following MCP tools:
Retrieves the latest version of a specific session summary.
Parameters:
- sessionId (string, required): The unique ID of the session summary to retrieve.
- maxLength (number, optional): If provided, truncate the retrieved summary text to this maximum length.
Returns:
- The latest session summary object (in JSON format)
Lists available summaries (only the latest version of each session), with support for filtering, sorting, and pagination.
Parameters:
- tag (string, optional): Filter sessions by a specific tag.
- limit (number, optional): Limit results.
- offset (number, optional): Offset for pagination.
- sortBy (string, optional): Sort field ('lastUpdated' or 'title'). Default: 'lastUpdated'.
- order (string, optional): Sort order ('asc' or 'desc'). Default: 'desc'.
Returns:
- List of summary metadata objects (in JSON format), with only the latest version per session
Lists all available summaries with basic information (only the latest version of each session).
Parameters:
- None
Returns:
- List of all available summaries with basic information (in JSON format)
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server memo": {
"mcp-server-memo": {
"command": "node",
"args": [
"dist/index.js"
]
}
}
}
}McpServers
{
"mcp-server-memo": {
"command": "node",
"args": [
"dist/index.js"
]
}
}
A lightweight MCP (Model Context Protocol) server for managing rich session summaries and memos for LLMs like Claude. This server provides persistent storage using the local filesystem, with support for session history version tracking, and offers tools for storing, retrieving, and listing summaries.
Overview
MCP Server Memo is designed as a memory assistant for LLMs, allowing them to store and retrieve detailed session records through the MCP tool interface. The server:
- Preserves History - All historical versions of a session (same sessionId) are preserved, not just the latest version
- Time-Ordered - Multiple versions of sessions are organized chronologically, making it easy to track conversation development
- Local Storage - Uses the local filesystem without requiring an external database
- MCP Compliant - Follows the Model Context Protocol specification to provide tool interfaces
- Performance Optimized - Optimized for file I/O and concurrent operations
- Minimal Dependencies - Clean design that's easy to maintain and extend
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
