memos-mcp-server

A MCP(Model Context Protocol) server for Memos.

Catalog onlyCatalog onlySTDIO

Overview

The mcp-server-memos is a server implementation for the Model Context Protocol (MCP) designed to work with Memos, a memo management tool.

To use mcp-server-memos, set up the server with the required environment variables and use the provided commands to create and search memos.

Search memos using keywords. - Create new memos easily with a simple command structure.

Managing personal notes and memos efficiently.
Integrating memo management into applications using the MCP.
Facilitating collaborative memo sharing and searching.

Add to your AI client

Use these steps to connect memos-mcp-server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-memos-leslieleung": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-memos-leslieleung"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-server-memos-leslieleung": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-memos-leslieleung"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-server-memos-leslieleung": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-memos-leslieleung"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-server-memos-leslieleung": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-memos-leslieleung"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-memos-leslieleung": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-memos-leslieleung"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-server-memos-leslieleung": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-server-memos-leslieleung"
      ]
    }
  }
}

FAQ

What is the MCP?

The Model Context Protocol (MCP) is a protocol designed to standardize the way context is shared between applications.

How do I set up the server?

You need to configure the server with the MEMOS_URL and MEMOS_API_KEY in the environment variables.

Is there a limit to the number of memos I can create?

There is no hard limit, but performance may vary based on the underlying storage and server capabilities.

Developer tools