memos-mcp-server

memos-mcp-server

3.2

If you are the rightful owner of memos-mcp-server 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@mcpreview.com.

A Model Context Protocol (MCP) server for integrating Memos with AI assistants that support the MCP protocol.

Memos MCP Server

A Model Context Protocol (MCP) server for integrating Memos with AI assistants that support the MCP protocol, such as Claude.

โœจ Features

  • Search memos using keywords
  • Create new memos with customizable visibility settings and tags
  • Retrieve specific memos by ID
  • Get user information

๐Ÿš€ Installation

Claude Desktop Setup

  1. Install Claude Desktop

    • Download Claude Desktop
    • Ensure you have the latest version (Menu: Claude -> Check for Updates...)
  2. Configure MCP Server

    {
      "mcpServers": {
        "memos": {
          "command": "npx",
          "args": [
            "memos-mcp-server"
          ],
          "env": {
            "MEMOS_URL": "https://your-memos-instance.com",
            "MEMOS_API_KEY": "your_api_key"
          }
        }
      }
    }
    

๐Ÿ› ๏ธ Available Tools

search_memo

Search for memos using keywords.

Parameters:

  • key_word (string): The keywords to search for in memo content
  • state (string, optional): The state of memos to list (default: "NORMAL", can also be "ARCHIVED")

create_memo

Create a new memo.

Parameters:

  • content (string): Memo content
  • visibility (string, optional): Visibility setting (default: "PRIVATE", options: "PUBLIC", "PROTECTED", "PRIVATE")
  • tags (array of strings, optional): List of tags for the memo

get_memo

Retrieve a specific memo by its ID.

Parameters:

  • name (string): Memo name, format is memos/{id} or just the ID number

get_user

Get current user information.

๐Ÿงช Development

This project uses TypeScript with the FastMCP framework for MCP server development.

Setup

# Install dependencies
npm install

# Create .env file and set environment variables
cp .env.example .env
# Edit .env file with your Memos API details

Development Mode

npm run dev

Build

npm run build

Run Production Server

npm start

Test with mcp-cli

The fastest way to test and debug your server is with fastmcp dev:

npx fastmcp dev src/server.ts

This will run your server with mcp-cli for testing and debugging your MCP server in the terminal.

Inspect with MCP Inspector

You can also use the official MCP Inspector to inspect your server with a Web UI:

npx fastmcp inspect src/server.ts

๐Ÿค Contributing

Contributions, issues and feature requests are welcome! Visit the issues page.

๐Ÿ“„ License

- Copyright (c) 2025 Stephen J. Li