Mowen Note is an MCP server that integrates the Mowen Note API with Model Context Protocol clients like Cursor and Claude Desktop. Developed by the Yizhiyanhua community in collaboration with Mowen, it allows knowledge workers and developers with a Mowen Pro subscription to automate their note-taking workflows directly from their AI assistants. The server enables users to create, read, and edit structured rich-text notes using consistent paragraph components. Users can insert text formatted with bold styling, highlights, and hyperlinks, as well as quote blocks and cross-references that link back to other notes created through the API. Additionally, it supports uploading and embedding images, audio recordings, and PDF documents sourced from local file paths or remote web URLs. Through built-in management tools, it also allows AI assistants to configure note visibility, set sharing expiration rules, and reset authentication credentials.
Category: Files, Documents & PDFs
Tags: file-upload, knowledge-management, mowen, notes
bash git clone https://github.com/z4656207/mowen-mcp-server.git cd mowen-mcp-server pip install -e . 3. Add the server to your MCP client configuration (such as Cursor) under mcpServers: json { "mcpServers": { "mowen-mcp-server": { "command": "python", "args": ["-m", "mowen_mcp_server.server"], "env": { "MOWEN_API_KEY": "your_api_key_here" } } } } 4. Alternatively, use the standalone Windows binary (mowen-mcp-server.exe) by passing its absolute path as the command value.Part of MCP Servers
You can install Mowen Note by cloning the GitHub repository and running pip install -e . in Python 3.10 or higher. Windows users can also download the standalone executable release mowen-mcp-server.exe and run it directly without a manual Python environment setup.
It provides tools to create rich-text notes, completely replace note content via editing, attach local or remote images, audio, and PDFs, link existing API-created notes together, configure privacy permissions, and reset account API keys.
Mowen Note supports standard Model Context Protocol clients that allow custom stdio server execution, including Cursor and Claude Desktop, provided the MOWEN_API_KEY environment variable is configured.
File uploads require absolute file paths because the MCP client and the MCP server process run in separate working directories. Relative paths will fail to resolve correctly.
No, the Mowen API only supports modifying and managing notes that were originally created through the API itself. Notes created manually within the mini program cannot be edited.
Yes, Mowen Note is open source and distributed under the MIT license, with source code available on GitHub. Using the underlying Mowen API requires an active Mowen Pro subscription.