Memos MCP Server

by stephen9412

460 downloads
Not rated
GitHub

About

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

Details

Author
stephen9412
Downloads
460
Categories
Other

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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Memos MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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

```bash

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.