mcp-server-memos-py
If you are the rightful owner of mcp-server-memos-py and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Python package that provides LLM models with the ability to interact with Memos server through the MCP interface.
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"
]
}
}
}
Other ways to use this package
๐ฆ 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)
๐ง 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 file for details.
๐ Acknowledgments
- Memos - A lightweight, self-hosted memo hub
- MCP (Model Context Protocol) - Protocol for LLM model applications
