Memos MCP Server

by stephen9412

460 downloads Not rated yet MIT license
GitHub

About

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

Details

License
MIT license

Explore

- Search memos using keywords
- Create new memos with customizable visibility settings and tags
- Retrieve specific memos by ID
- Get 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


1. Install Claude Desktop
   - Download Claude Desktop
   - Ensure you have the latest version (Menu: Claude -> Check for Updates...)

2. Configure MCP Server

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

npm install

cp .env.example .env

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"
        ]
    }
}

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.