MCP Server Memos 📝
About
A Python package enabling LLM models to interact with the Memos server via the MCP interface for searching, creating, retrieving, and managing memos.
Details
- Author
- RyoJerryYu
- GitHub stars
- 21
- Downloads
- 379
- Categories
- Other
Jump to
- 🔍 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
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 Memos 📝Command (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
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp server memos \ud83d\udcdd": {
"mcp-server-memos-py": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@RyoJerryYu/mcp-server-memos-py",
"--client",
"claude"
]
}
}
}
}McpServers
{
"mcp-server-memos-py": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@RyoJerryYu/mcp-server-memos-py",
"--client",
"claude"
]
}
}MCP Server Memos 📝
A Python package that provides LLM models with the ability to interact with Memos server through the MCP (Model Context Protocol) interface.
🚀 Features
- 🔍 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
🛠️ Usage
You can include this package in your config file as bellow, just as you use other Python MCP plugins.
{
...,
"mcpServers": {
"fetch": { // other mcp servers
"command": "uvx",
"args": ["mcp-server-fetch"]
},
"memos": { // add this to your config
"command": "uvx",
"args": [
"--prerelease=allow",
"mcp-server-memos",
"--host",
"localhost",
"--port",
"5230",
"--token",
"your-access-token-here"
]
}
}
}
<details>
<summary>Other ways to use this package</summary>
📦 Installation
Installing via Smithery
To install mcp-server-memos-py for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @RyoJerryYu/mcp-server-memos-py --client claude
Installing Manually
pip install mcp-server-memos
Command Line
mcp-server-memos --host localhost --port 8080 --token YOUR_ACCESS_TOKEN
As a Library
from mcp_server_memos import Config, serve_stdio
config = Config(
host="localhost",
port=8080,
token="YOUR_ACCESS_TOKEN"
)
await serve_stdio(config=config)
</details>
🔧 Configuration
| Parameter | Description | Default |
|-----------|-------------|---------|
| host | Memos server hostname | localhost |
| port | Memos server port | 8080 |
| token | Access token for authentication | "" |
🤝 Available Tools
This MCP server provides the following tools for interacting with Memos:
| Tool Name | Description | Parameters |
|-----------|-------------|------------|
| list_memo_tags | List all existing memo tags | - parent: The parent who owns the tags (format: memos/{id}, default: "memos/-")<br>- visibility: Tag visibility (PUBLIC/PROTECTED/PRIVATE, default: PRIVATE) |
| search_memo | Search for memos using keywords | - key_word: The keywords to search for in memo content |
| create_memo | Create a new memo | - content: The content of the memo<br>- visibility: Memo visibility (PUBLIC/PROTECTED/PRIVATE, default: PRIVATE) |
| get_memo | Get a specific memo by ID | - name: The name/ID of the memo (format: memos/{id}) |
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Memos - A lightweight, self-hosted memo hub
- MCP (Model Context Protocol) - Protocol for LLM model applications
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
