Mowen

v1.0.0Knowledge & Memorystable

墨问笔记API的MCP服务器封装,支持在Cursor、Claude Desktop等MCP客户端中操作墨问笔记

mowenmcpai-integration
Share:
46
Stars
0
Downloads
0
Weekly
0/5

What is Mowen?

Mowen is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 墨问笔记api的mcp服务器封装,支持在cursor、claude desktop等mcp客户端中操作墨问笔记

墨问笔记API的MCP服务器封装,支持在Cursor、Claude Desktop等MCP客户端中操作墨问笔记

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

Features

  • 墨问笔记API的MCP服务器封装,支持在Cursor、Claude Desktop等MCP客户端中操作墨问笔记

Use Cases

Interact with Mowen Notes API through MCP
Manage rich text notes in MCP-compatible clients
z4656207

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMar 3, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mowen

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

The Mowen MCP server wraps the Mowen Notes (墨问笔记) API, enabling AI assistants in Cursor, Claude Desktop, and other MCP clients to create, edit, and manage rich-text notes directly in your Mowen account. It supports structured content including bold text, highlights, hyperlinks, quoted sections, internal note references, and file attachments (images, audio, PDFs). Developers and knowledge workers who use Mowen as their note-taking platform can use this server to have AI agents draft and publish notes without leaving their coding or chat environment.

Prerequisites

  • Python 3.8+ installed
  • pip available for installing dependencies
  • A Mowen (墨问笔记) account and API key from the Mowen platform
  • An MCP-compatible client such as Claude Desktop or Cursor
1

Clone the repository

Clone the mowen-mcp-server repository to your local machine.

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

Install Python dependencies

Install the required packages: mcp for the MCP framework, httpx for HTTP requests, and pydantic for data validation.

pip install mcp httpx pydantic
3

Install the package in editable mode

Install the package so the mowen_mcp_server module is importable from anywhere on your system.

pip install -e .
4

Set the MOWEN_API_KEY environment variable

Obtain your API key from the Mowen platform settings and export it in your shell, or add it to your MCP client config's env block.

export MOWEN_API_KEY=your_mowen_api_key_here
5

Configure your MCP client

Add the server to your claude_desktop_config.json or Cursor MCP settings, passing the API key through the environment.

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

Mowen Examples

Client configuration

Claude Desktop or Cursor configuration to launch the Mowen MCP server using the installed Python module.

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

Prompts to try

Natural language prompts you can use once the Mowen MCP server is connected to your AI assistant.

- "Create a new Mowen note titled 'Meeting Summary' with today's key points"
- "Add a note to Mowen with a quoted section and the tag 'learning'"
- "Edit my existing Mowen note to add a bold heading at the top"
- "Create a note in Mowen and attach the image at /Users/me/screenshot.png"

Troubleshooting Mowen

Server fails with 'MOWEN_API_KEY not set' or authentication error

Ensure MOWEN_API_KEY is set in the env block of your MCP client config. The value must be your actual Mowen API key — you can regenerate it using the reset_api_key tool if your key has expired.

Module not found error when starting the server

Run pip install -e . from inside the cloned mowen-mcp-server directory to make the mowen_mcp_server package importable. If using a virtual environment, ensure it is activated when configuring the client, or use the full path to the Python executable.

File attachments fail to upload

Verify the file path is an absolute path and the file exists and is readable. For remote URLs, ensure the URL is publicly accessible. Supported file types are images, audio files, and PDFs.

Frequently Asked Questions about Mowen

What is Mowen?

Mowen is a Model Context Protocol (MCP) server that 墨问笔记api的mcp服务器封装,支持在cursor、claude desktop等mcp客户端中操作墨问笔记 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Mowen?

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

Which AI clients work with Mowen?

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

Is Mowen free to use?

Yes, Mowen is open source and available under the MIT 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": { "command": "npx", "args": ["-y", "mowen"] } } }

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

Read the full setup guide →

Ready to use Mowen?

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