MCP Server Memos 📝
@RyoJerryYu
A Python package enabling LLM models to interact with the Memos server via the MCP interface for searching, creating, retrieving, and managing memos.
概要
What is MCP Server Memos 📝?
MCP Server Memos 📝 is a Python package that gives LLM models the ability to interact with a Memos server through the Model Context Protocol (MCP) interface. It is designed for developers building LLM-powered applications that need to search, create, and manage self‑hosted memo notes.
How to use MCP Server Memos 📝?
Install the package via pip install mcp-server-memos or automatically through Smithery. Configure it with a hostname, port, and access token, then add it to your MCP client’s configuration file (e.g., "mcpServers" in Claude Desktop). You can also run it directly from the command line: mcp-server-memos --host localhost --port 8080 --token YOUR_ACCESS_TOKEN.
Key features of MCP Server Memos 📝
- 🔍 Search memos with keywords
- ✨ Create new memos with customizable visibility
- 📖 Retrieve memo content by ID
- 🏷️ List and manage memo tags
- 🔐 Secure authentication using access tokens
Use cases of MCP Server Memos 📝
- Let an LLM assistant search your personal knowledge base of memo notes
- Automatically create meeting notes or reminders as memos
- Retrieve and display a specific memo by its ID during a conversation
- Manage memo tags for organisation through natural language commands
FAQ from MCP Server Memos 📝
What is Memos?
Memos is a lightweight, self‑hosted memo hub. It allows you to store short notes and snippets on your own server.
How do I install MCP Server Memos 📝?
You can install it via pip install mcp-server-memos or use Smithery’s CLI: npx -y @smithery/cli install @RyoJerryYu/mcp-server-memos-py --client claude.
What configuration is required?
You need to provide the hostname and port of your Memos server (defaults: localhost and 8080) and an access token for authentication. These can be set as command‑line arguments or in a Python Config object.
What tools does the server provide?
It offers four tools: list_memo_tags (list tags), search_memo (search by keyword), create_memo (create a new memo with a chosen visibility), and get_memo (retrieve a memo by its ID).
Does the server support authentication?
Yes. It uses an access token passed via the --token parameter or token config field. The token is sent to the Memos server for every request.
