
Mcp Memos
io.github.jkawamotoPublished by GitHub account jkawamotov0.1.0Updated Oct 24, 2026
An MCP server for interacting with Memos.
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.
Installation
In SourceWeft
- Open Mcp Memos in the dashboard and add it to a workspace.
- 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
uvinstalled on your system to useuvxcommand.
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:
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:
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_ENDPOINTwith Memos server address andMEMOS_API_TOKENwith 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
0Version history
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