MMCPMarkets
ZM

z4656207/mowen-mcp-server

Developer tools

This page was translated automatically. Technical details may differ from the original. View the original

47 stars 7 forks Quality 66 Trend 13MIT
Repository Install

The Mowen Note API is an MCP server encapsulation, supporting Mowen Notes operations on MCP clients such as Cursor and Claude Desktop

Overview

This is a **-based server used to interact with Mowen Note software. Through this server, you can create, edit, and manage Mowen Note directly in MCP-supported applications (such as Cursor, Claude Desktop, etc.). 1. Download mowen-mcp-server-windows-x64-v1.0.0.zip and extract the mowen-mcp-server.exe 2. In the MCP client, modify the command value and replace it with the path of the mowen-mcp-server.exe file - 🔗 : Supports the latest MCP 1.9.1 version - 📝 : Unified rich text format, supports paragraph, bold, highlighting, links, references, and internal notes - ✏️ : Unified rich text format, fully replaces note content - 📁 : Supports uploading images, audio, PDF files, local files, and remote URLs - 💬 : Creates reference text blocks, supports rich text format - 🔗 : Referencing other notes, creating associations between notes - 🔒 : Setting public, private, or rule permissions for notes - 🔄 : Resetting API key function - 🎨 : All note operations use consistent rich text parameter format - Python 3.10+ - Mowen Pro member account (API functionality only available to Pro members) - Mowen API key (obtained from Mowen mini program) If you use pip install -e . to install, add in the Cursor settings: : Please replace the absolute path with your actual project path, for example: - Windows: "D:/CODE/mowen-mcp-server/src/mowen_mcp_server/server.py" - macOS/Linux: "/home/user/mowen-mcp-server/src/mowen_mcp_server/server.py" - paragraphs (arrays, required): List of rich text paragraphs, each paragraph contains text nodes - auto_publish (boolean value, optional): Whether to publish automatically, default false - tags (string array, optional): List of note tags 1. (Default): {"texts": [...]} 2. ：{"type": "quote", "texts": [...]} 3. :{"type": "note", "note_id": "Note ID"} 4.

Overview (machine translated)

This is a server based on Model Context Protocol (MCP) for interacting with Mowen Note software. Through this server, you can create, edit, and manage Mowen Notes directly in MCP-supported applications (such as Cursor, Claude Desktop, etc.).

This project is a collaboration between Yiyihua Community and Mowen.

🆕 The Portable Version Is Now Available (Beginners Welcome)

Usage Instructions (Windows Example)

  1. Download mowen-mcp-server-windows-x64-v1.0.0.zip and extract the mowen-mcp-server.exe
  2. In the MCP client, modify the command value and replace it with the path of the mowen-mcp-server.exe file

✨ ** Latest version features: Supports file upload! You can now insert images, audio, and PDF files into notes, supporting both local file and remote URL upload methods. **

🆕 New Features Preview (v0.2.0)

📁 File upload support

⚠️ Important: File paths must use absolute paths because MCP Server and Client run in different working directories.

📝 Quoted Paragraphs

🔗 Internal Link Notes

Functional Features

  • 🔗 Compatible with MCP protocol: Supports the latest MCP version 1.9.1
  • 📝 Create Notes: Unified rich text format supporting paragraphs, bold, highlights, links, citations, and internal linking notes
  • ✏️ Edit notes: Unified rich text format that completely replaces note content
  • 📁 File Upload: Supports uploading images, audio, and PDF files, as well as local files and remote URLs
  • 💬 Reference Paragraphs: Create citation text blocks supporting rich text formatting
  • 🔗 Internal Notes Linking: References other notes to create associations between them
  • 🔒 Privacy Settings: Set permission for notes to be public, private, or rule exposure
  • 🔄 Key Management: API key reset function
  • 🎨 Unified Interface: All note-taking operations use consistent rich text parameter formats

Get Started Quickly

Prerequisites

  • Python 3.10+
  • Mowen Pro Member Account (API functionality available only to Pro members)
  • Mowen API key (obtained from the Mowen mini-program)

Installation Method

  1. Cloning Project:

  2. Installation Dependencies:

Method 2: Directly install dependencies

Configure API Keys

Windows PowerShell

Linux/macOS

Persistence settings

Create .env file:

Configure the MCP client

If you installed with pip install -e ., add in the Cursor settings:

Method 2: Direct file path method

If you don’t have an installation package, you can directly specify the file path:

Note: Please replace 绝对路径 with your actual project path, for example:

This page was translated automatically. Technical details may differ from the original.

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{ "mcpServers": { "mowen-mcp-server": { "command": "D:\\mowen\\mowen-mcp-server.exe", "args": [], "env": { "MOWEN_API_KEY": "xxxxxxxxxxxxxxx" } } } }