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.

{ ..., "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" ] } } }

📦 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

ParameterDescriptionDefault
hostMemos server hostnamelocalhost
portMemos server port8080
tokenAccess token for authentication""

🤝 Available Tools

This MCP server provides the following tools for interacting with Memos:

Tool NameDescriptionParameters
list_memo_tagsList 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_memoSearch for memos using keywords- key_word: The keywords to search for in memo content
create_memoCreate a new memo- content: The content of the memo- visibility: Memo visibility (PUBLIC/PROTECTED/PRIVATE, default: PRIVATE)
get_memoGet 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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. 🚀 Features
    1. 🛠️ Usage
      1. 📦 Installation
      2. Command Line
      3. As a Library
    2. 🔧 Configuration
      1. 🤝 Available Tools
        1. 🤝 Contributing
          1. 📄 License
            1. 🙏 Acknowledgments