memos-mcp-server

memos-mcp-server

0

Memos MCP Server is a Model Context Protocol server designed to integrate Memos with AI assistants. It offers features for searching, creating, and retrieving memos, as well as getting user information, utilizing the FastMCP framework for development.

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