memos-mcp-server
Memos MCP Server is a Model Context Protocol server designed to integrate Memos with AI assistants. It offers features for searching, creating, and retrieving memos, as well as getting user information, utilizing the FastMCP framework for development.
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