MCP.so
Sign In

Memos MCP Server

@stephen9412

About Memos MCP Server

A Model Context Protocol (MCP) server for Memos API with search, create, retrieve, and tag listing capabilities.

Basic information

Category

Other

License

MIT license

Runtime

node

Transports

stdio

Publisher

stephen9412

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "memos-mcp-server": {
      "command": "npx",
      "args": [
        "fastmcp",
        "dev",
        "src/server.ts"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Memos MCP Server?

A Model Context Protocol (MCP) server that integrates the self‑hosted memo/note app Memos with MCP‑compatible AI assistants such as Claude. It enables searching, creating, retrieving memos, and fetching user information.

How to use Memos MCP Server?

Install via npx (the package memos-mcp-server) or run the built server locally. Configure it in your MCP client (e.g., Claude Desktop) by adding an entry to mcpServers with the command npx memos-mcp-server and environment variables MEMOS_URL (your Memos instance URL) and MEMOS_API_KEY. After configuration, the server exposes tools for searching, creating, retrieving memos, and getting user info.

Key features of Memos MCP Server?

  • Search memos using keywords
  • Create memos with customizable visibility and tags
  • Retrieve a specific memo by its ID
  • Get current user information

Use cases of Memos MCP Server?

  • Search through your personal memos by keyword from an AI assistant
  • Create a new memo with a specified visibility level and tags
  • Retrieve the content of a memo by its ID for review
  • Fetch information about the authenticated user

FAQ from Memos MCP Server

What do I need to use this server?

A running Memos instance and a valid API key. Set the MEMOS_URL (URL of your Memos instance) and MEMOS_API_KEY environment variables.

How do I configure it for Claude Desktop?

Add a JSON entry under mcpServers in your Claude Desktop configuration, using the command npx memos-mcp-server and the two environment variables as shown in the README.

What tools are available?

Four tools: search_memo, create_memo, get_memo, and get_user. Each has documented parameters; for instance, search_memo accepts a keyword and an optional state (NORMAL or ARCHIVED).

Can I specify the visibility of a new memo?

Yes. The create_memo tool has an optional visibility parameter with values PUBLIC, PROTECTED, or PRIVATE (default is PRIVATE).

How do I retrieve a memo by ID?

Use the get_memo tool with the name parameter in the format memos/{id} or the numeric ID alone.

Comments

More Other MCP servers