MCP Server Memos
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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.
📦 Installation
Installing via Smithery
To install mcp-server-memos-py for Claude Desktop automatically via Smithery:
Installing Manually
Command Line
As a Library
🔧 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/-")- 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- 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
You must be authenticated.
A Python package that enables LLM models to interact with Memos server through the Model Context Protocol interface, allowing search, creation, retrieval, and management of memos.