Mowen Notes

v1.0.0Knowledge & Memorystable

Enables interaction with Mowen Notes to create, edit, and manage rich text content including file uploads and internal note links. It allows users to manage their notes directly within MCP-compatible environments like Cursor or Claude Desktop.

mowen-notes-mcp-servermcpai-integration
Share:
46
Stars
0
Downloads
0
Weekly
0/5

What is Mowen Notes?

Mowen Notes is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables interaction with mowen notes to create, edit, and manage rich text content including file uploads and internal note links. it allows users to manage their notes directly within mcp-compatible ...

Enables interaction with Mowen Notes to create, edit, and manage rich text content including file uploads and internal note links. It allows users to manage their notes directly within MCP-compatible environments like Cursor or Claude Desktop.

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables interaction with Mowen Notes to create, edit, and ma

Use Cases

Create and edit rich text notes with file uploads
Manage notes directly in Cursor or Claude Desktop
z4656207

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMar 3, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mowen-notes-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Mowen Notes

The Mowen Notes MCP Server connects AI assistants to the Mowen (墨问) note-taking platform, a Chinese rich-text knowledge tool, enabling creation and editing of notes with bold/highlighted text, internal note links, file and image attachments, and tag management. It exposes tools for creating notes in a structured paragraph format, editing existing notes, and configuring note privacy — all accessible from MCP clients like Claude Desktop or Cursor. Writers and knowledge workers use it to capture AI-generated insights directly into their Mowen library without leaving the chat interface.

Prerequisites

  • Python 3.10 or higher installed
  • A Mowen account with Pro membership (required for API access)
  • A Mowen API key obtained from the Mowen mini-program developer settings
  • pip for installing Python dependencies
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Clone the repository

Clone the Mowen MCP server source to your local machine.

git clone https://github.com/z4656207/mowen-mcp-server.git
cd mowen-mcp-server
2

Install Python dependencies

Install the package in editable mode using pip, which installs mcp, httpx, and pydantic.

pip install -e .
3

Obtain your Mowen API key

Open the Mowen mini-program on your device, navigate to developer settings, and generate an API key. This requires an active Pro membership.

4

Set the MOWEN_API_KEY environment variable

Export the API key so the server can authenticate with the Mowen API.

# macOS/Linux
export MOWEN_API_KEY=your_mowen_api_key_here

# Windows PowerShell
$env:MOWEN_API_KEY="your_mowen_api_key_here"
5

Configure your MCP client

Add the server to your MCP client config. The server is run as a Python module after installation.

6

Test by creating a note

Ask your AI client to create a simple test note to verify the connection is working.

Mowen Notes Examples

Client configuration

Add this block to claude_desktop_config.json. The server runs as a Python module installed via pip install -e .

{
  "mcpServers": {
    "mowen-notes": {
      "command": "python",
      "args": ["-m", "mowen_mcp_server.server"],
      "env": {
        "MOWEN_API_KEY": "your_mowen_api_key_here"
      }
    }
  }
}

Prompts to try

Use natural language to create and manage Mowen notes.

- "Create a Mowen note summarizing today's meeting with the key decisions bolded"
- "Add a note titled 'Reading List' with three items highlighted in yellow"
- "Create a note tagged 'research' with an internal link to my existing note on AI trends"
- "Edit note ID abc123 to update the second paragraph with the new deadline"
- "Set note xyz789 to public visibility"

Troubleshooting Mowen Notes

API returns 401 or authentication error

Your MOWEN_API_KEY may be expired or invalid. Open the Mowen mini-program developer settings and regenerate the key, then update it in your MCP config env block.

create_note tool fails with a validation error about paragraphs

The paragraphs parameter must be a JSON array of paragraph objects. Each paragraph needs a `texts` array with at least one object containing a `text` key. Check your input matches the expected structure.

Daily quota exceeded error

The Mowen API enforces daily limits: 100 note creations, 1000 edits, and 100 privacy changes. If you hit these limits, wait until midnight (Mowen server time) for the quota to reset.

Frequently Asked Questions about Mowen Notes

What is Mowen Notes?

Mowen Notes is a Model Context Protocol (MCP) server that enables interaction with mowen notes to create, edit, and manage rich text content including file uploads and internal note links. it allows users to manage their notes directly within mcp-compatible environments like cursor or claude desktop. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Mowen Notes?

Follow the installation instructions on the Mowen Notes GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Mowen Notes?

Mowen Notes works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Mowen Notes free to use?

Yes, Mowen Notes is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mowen-notes-mcp-server": { "command": "npx", "args": ["-y", "mowen-notes-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Mowen Notes?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides