Skip to main content
Glama
Memos MCP Server

Memos MCP Server

by kinmeic

Memos MCP Server

A Model Context Protocol (MCP) server for interacting with Memos API.

Features

  • Create Memos: Create new memos with Markdown content

  • List Memos: List memos with pagination, sorting, and CEL filter support

  • Get Memo: Retrieve a specific memo by ID

  • Update Memo: Update existing memo content and metadata

  • Delete Memo: Delete memos

  • Memo Attachments: List and set memo attachments

  • Attachment Service: Create, list, get, update, and delete individual attachments

Related MCP server: memopaper-mcp

Installation

  1. Clone this repository or download the files

  2. Install dependencies:

npm install
  1. Build the project:

npm run build
  1. Set up environment variables:

export MEMOS_BASE_URL="https://your-memos-instance.com"
export MEMOS_API_KEY="your-api-token"

For Memos API key, go to your Memos instance -> Settings -> API to generate a token.

Configuration

The server uses the following environment variables:

Variable

Required

Default

Description

MEMOS_BASE_URL

No

https://demo.usememos.com

Your Memos instance base URL

MEMOS_API_KEY

No

(empty)

Your Memos API access token

Usage

Running the Server

npm start

Or for development with auto-reload:

npm run dev

MCP Tools

The server provides the following tools:

create_memo

Create a new memo.

Parameters:

  • content (required): The memo content in Markdown format

  • visibility (optional): Visibility level - PRIVATE, PROTECTED, or PUBLIC (default: PRIVATE)

  • state (optional): Memo state - NORMAL or ARCHIVED (default: NORMAL)

  • pinned (optional): Whether to pin the memo (default: false)

Example:

{
  "content": "# My First Memo\n\nThis is a **markdown** memo.",
  "visibility": "PRIVATE",
  "pinned": false
}

list_memos

List memos with pagination, sorting, and CEL filter support.

Parameters:

  • pageSize (optional): Maximum number of memos to return (default: 50, max: 1000)

  • pageToken (optional): Page token from previous response for pagination

  • state (optional): Filter by state - NORMAL or ARCHIVED (default: NORMAL)

  • orderBy (optional): Sort order (default: display_time desc). Supports: pinned, display_time, create_time, update_time, name

  • filter (optional): CEL expression for advanced filtering (e.g., visibility == 'PUBLIC')

  • show_deleted (optional): Include deleted memos (default: false)

Examples:

// Basic list
{
  "pageSize": 50,
  "state": "NORMAL"
}

// With CEL filter
{
  "filter": "visibility == 'PUBLIC' && content.contains('meeting')",
  "orderBy": "pinned desc, display_time desc"
}

// Pagination
{
  "pageSize": 50,
  "pageToken": "eyJwYWdlU2l6ZSI6IDUwfQ=="
}

get_memo

Get a specific memo by ID.

Parameters:

  • memoId (required): The memo ID (e.g., 123 or memos/123)

update_memo

Update an existing memo.

Parameters:

  • memoId (required): The memo ID to update

  • content (optional): New content for the memo

  • visibility (optional): New visibility setting

  • state (optional): New state setting

  • pinned (optional): New pinned state

delete_memo

Delete a memo.

Parameters:

  • memoId (required): The memo ID to delete

list_memo_attachments

List all attachments for a specific memo.

Parameters:

  • memoId (required): The memo ID (e.g., 123 or memos/123)

  • pageSize (optional): Maximum number of attachments to return (default: 50, max: 1000)

  • pageToken (optional): Page token for pagination

Example:

{
  "memoId": "123",
  "pageSize": 100
}

set_memo_attachments

Set attachments for a memo (replaces all existing attachments).

Parameters:

  • memoId (required): The memo ID

  • attachments (required): List of attachment objects (use camelCase for attachment fields)

    • filename (required): The filename

    • type (required): MIME type (e.g., image/png, application/pdf)

    • content (optional): Base64 encoded file content

    • externalLink (optional): External URL (camelCase)

Note: Use content OR externalLink, not both. Do NOT include size or createTime (these are server-generated).

Important: Attachment fields must use camelCase (externalLink, not external_link) as they match the API specification.

Example:

{
  "memoId": "123",
  "attachments": [
    {
      "filename": "document.pdf",
      "type": "application/pdf",
      "externalLink": "https://example.com/doc.pdf"
    },
    {
      "filename": "small-image.png",
      "type": "image/png",
      "content": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
    }
  ]
}

create_attachment

Create a new attachment (can be linked to memos later).

Parameters:

  • filename (required): The filename

  • type (required): MIME type (e.g., image/png, application/pdf)

  • attachment_id (optional): Custom attachment ID

  • external_link (optional): External URL

  • memo (optional): Related memo resource name (format: memos/{memo})

Example:

{
  "filename": "document.pdf",
  "type": "application/pdf",
  "external_link": "https://example.com/doc.pdf",
  "memo": "memos/123"
}

get_attachment

Get a specific attachment by ID.

Parameters:

  • attachment_id (required): The attachment ID (e.g., 123 or attachments/123)

list_attachments

List all attachments with pagination, filtering, and sorting.

Parameters:

  • page_size (optional): Maximum number of attachments to return (default: 50, max: 1000)

  • page_token (optional): Page token for pagination

  • filter (optional): CEL expression for filtering

  • order_by (optional): Sort order (e.g., create_time desc, filename asc)

Examples:

// Basic list
{
  "page_size": 100
}

// With CEL filter
{
  "filter": "mime_type==\"image/png\"",
  "orderBy": "create_time desc"
}

// Filter by memo
{
  "filter": "memo==\"memos/123\""
}

update_attachment

Update an existing attachment.

Parameters:

  • attachment_id (required): The attachment ID to update

  • update_mask (required): Comma-separated list of fields to update (e.g., filename,type,externalLink)

  • filename (optional): New filename

  • type (optional): New MIME type

  • external_link (optional): New external URL

  • memo (optional): New related memo resource name

Example:

{
  "attachmentId": "123"",
  "update_mask": "filename,externalLink",
  "filename": "updated-name.pdf",
  "external_link": "https://example.com/new-url.pdf"
}

delete_attachment

Delete an attachment by ID.

Parameters:

  • attachment_id (required): The attachment ID to delete

MCP Resources

The server provides the following resources:

  • memos://memos: All memos from your Memos instance

  • memos://config: Current server configuration

Claude Desktop Integration

To use this server with Claude Desktop, add it to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memos": {
      "command": "node",
      "args": ["/path/to/memos-mcp/dist/index.js"],
      "env": {
        "MEMOS_BASE_URL": "https://your-memos-instance.com",
        "MEMOS_API_KEY": "your-api-token"
      }
    }
  }
}

Development

Project Structure

memos-mcp/
├── package.json           # Node.js project configuration
├── tsconfig.json          # TypeScript configuration
├── src/
│   ├── index.ts           # Entry point
│   ├── server.ts          # MCP server definition
│   ├── memos-client.ts    # Memos API client
│   ├── types.ts           # TypeScript type definitions
│   └── tools/
│       ├── memo-tools.ts      # Memo-related tools
│       └── attachment-tools.ts # Attachment-related tools
└── dist/                  # Compiled JavaScript output

License

MIT License

References

Available Tools

12 tools
create_attachmentB

Create a new attachment (can be linked to memos later)

Inputs: type (required), filename (required), memo, content, +1 more.

create_memoB

Create a new memo

Inputs: content (required), state, pinned, visibility.

delete_attachmentA

Delete an attachment by ID

Inputs: attachment_id (required).

delete_memoC

Delete a memo

Inputs: memoId (required).

get_attachmentB

Get a specific attachment by ID

Inputs: attachment_id (required).

get_memoB

Get a specific memo by ID

Inputs: memoId (required).

list_attachmentsA

List all attachments with pagination, filtering, and sorting

Inputs: filter, order_by, page_size, page_token.

list_memo_attachmentsA

List all attachments for a specific memo

Inputs: memoId (required), pageSize, pageToken.

list_memosA

List memos with pagination, sorting, and CEL filter support

Inputs: state, filter, orderBy, pageSize, +2 more.

set_memo_attachmentsB

Set attachments for a memo (replaces all existing attachments)

Inputs: memoId (required), attachments (required).

update_attachmentC

Update an existing attachment

Inputs: update_mask (required), attachment_id (required), memo, type, +2 more.

update_memoC

Update an existing memo

Inputs: memoId (required), state, pinned, content, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 12 tools

    Disambiguation5/5

    Each tool clearly targets a distinct resource and action: memo CRUD, attachment CRUD, and attachment-memo relationship operations are separated. list_memo_attachments and list_attachments are distinguished by scope, and set_memo_attachments is clearly different from create_attachment because one associates existing attachments while the other creates them.

    Naming Consistency5/5

    All tools follow a consistent snake_case verb_noun pattern: create_, list_, get_, update_, delete_ with the resource clearly named. The relationship tools set_memo_attachments and list_memo_attachments also align with this convention.

    Tool Count5/5

    12 tools is well-scoped for a server managing two related resources with full CRUD plus relationship operations. Each tool earns its place, and the count is neither bloated nor too thin.

    Completeness5/5

    Both memos and attachments have complete lifecycle coverage: create, read, list, update, delete. The additional memo-attachment relationship tools provide the missing linking capability, and set_memo_attachments allows replacement or clearing of attachments, covering all obvious workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers