Mcp Memos

io.github.jkawamotoPublished by GitHub account jkawamotov0.1.0Updated Oct 24, 2026

An MCP server for interacting with Memos.

Overview

AI-generated overview

A local MCP server that lets an assistant create memos and attach files in a Memos instance through its API.

What you can do
Create a memo with Markdown content and a chosen visibility (private, protected or public), returning the memo name. Attach a file to an existing memo by name, supplying base64 content or a file URL and an optional MIME type.
When to use it
Useful if you run a Memos server and want an assistant to capture notes or attach files to existing memos from a chat. Note that the project is archived because Memos now ships a native MCP server, so the built-in option is likely preferable.
Requirements
Runs locally as a stdio process, typically via uvx, so uv must be installed; a Claude Desktop bundle is also offered. Needs the Memos API endpoint and an API token, supplied as MEMOS_API_ENDPOINT and MEMOS_API_TOKEN, plus network access to the Memos server.
Before you install
Requires a Memos API token (MEMOS_API_TOKEN) that grants access to your Memos instance; keep it out of shared configuration. Creating memos and attaching files writes data to your Memos server, and public visibility makes a memo readable by others. The repository is archived and superseded by Memos' native MCP server.

Installation

In SourceWeft

  1. Open Mcp Memos in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[!NOTE] This repository is archived. As of v0.27.0, Memos now includes a native MCP server implementation, making this standalone server unnecessary.

Memos MCP Server

[Python Application] [GitHub License] [pre-commit] [Ruff]

An MCP server for interacting with Memos.

Tools

This MCP server provides the following tools:

create_memo

Create a memo and return the name of the memo.

Parameters
  • content (string): The content of the memo in Markdown format.
  • visibility (string, optional): The visibility of the memo (private, protected, public).

attach_file

Attach a file to a memo.

Parameters
  • memo_name (string): The name of the memo.
  • filename (string): The name of the file.
  • content (string): Base64 representation of a file or a URL to a file to attach to the memo.
  • mime_type (string, optional): The MIME type of the file.

Installation

[!NOTE] You'll need uv installed on your system to use uvx command.

For Claude Desktop

Download the latest MCP bundle mcp-memos.mcpb from the Releases page, then open the downloaded .mcpb file or drag it into the Claude Desktop's Settings window.

You can also manually configure this server for Claude Desktop. Edit the claude_desktop_config.json file by adding the following entry under mcpServers:

json
{  "mcpServers": {    "bear": {      "command": "uvx",      "args": [        "--from",        "git+https://github.com/jkawamoto/mcp-memos",        "mcp-memos",        "--endpoint",        "<Memos server address>",        "--token",        "<Your token>"      ]    }  }}

After editing, restart the application. For more information, see: For Claude Desktop Users - Model Context Protocol.

For Goose CLI

To enable the Bear extension in Goose CLI, edit the configuration file ~/.config/goose/config.yaml to include the following entry:

yaml
extensions:  bear:    name: Memos    cmd: uvx    args: [--from, git+https://github.com/jkawamoto/mcp-memos, mcp-memos]    envs: {      "MEMOS_API_ENDPOINT": "<Memos server address>",      "MEMOS_API_TOKEN": "<Your token>"    }    enabled: true    type: stdio

For Goose Desktop

Add a new extension with the following settings:

  • Type: Standard IO
  • ID: memos
  • Name: Memos MCP Server
  • Description: An MCP server for interacting with Memos
  • Command: uvx --from git+https://github.com/jkawamoto/mcp-memos mcp-memos
  • Environment Variables: Add MEMOS_API_ENDPOINT with Memos server address and MEMOS_API_TOKEN with your api token

For more details on configuring MCP servers in Goose Desktop, refer to the documentation: Using Extensions - MCP Servers.

License

This application is licensed under the MIT License. See the LICENSE file for more details.

Source: README.md at commit a13968b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts