MCP Server Memos

by RyoJerryYu

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

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                A Pyodide server for executing Python code by Large Language Models (LLMs) via the Model Context Protocol (MCP).
                Last updated -
                5
                3
                TypeScript
                MIT License
              • -
                security
                A
                license
                -
                quality
                A Model Context Protocol server enabling LLMs to search, retrieve, and manage documents through Rememberizer's knowledge management API.
                Last updated -
                19
                Python
                Apache 2.0
              • A
                security
                F
                license
                A
                quality
                A Python server implementing the Model Context Protocol to provide customizable prompt templates, resources, and tools that enhance LLM interactions in the continue.dev environment.
                Last updated -
                2
                Python
              • A
                security
                F
                license
                A
                quality
                A Model Context Protocol server that allows LLMs to interact with Python environments, execute code, and manage files within a specified working directory.
                Last updated -
                9
                8
                Python
                • Linux
                • Apple

              View all related MCP servers

              ID: strjm92qcp