memos-mcp-server
If you are the rightful owner of memos-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcpreview.com.
A Model Context Protocol (MCP) server for integrating Memos with AI assistants that support the MCP protocol.
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
-
Install Claude Desktop
- Download Claude Desktop
- Ensure you have the latest version (Menu: Claude -> Check for Updates...)
-
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 contentstate
(string, optional): The state of memos to list (default: "NORMAL", can also be "ARCHIVED")
create_memo
Create a new memo.
Parameters:
content
(string): Memo contentvisibility
(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 ismemos/{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
# Install dependencies
npm install
# Create .env file and set environment variables
cp .env.example .env
# Edit .env file with your Memos API details
Development Mode
npm run dev
Build
npm run build
Run Production Server
npm start
Test with mcp-cli
The fastest way to test and debug your server is with fastmcp dev
:
npx fastmcp dev src/server.ts
This will run your server with mcp-cli
for testing and debugging your MCP server in the terminal.
Inspect with MCP Inspector
You can also use the official MCP Inspector
to inspect your server with a Web UI:
npx fastmcp inspect src/server.ts
๐ค Contributing
Contributions, issues and feature requests are welcome! Visit the issues page.
๐ License
- Copyright (c) 2025 Stephen J. Li