# MindMax Write (npm · @mindmax/write-mcp)

Open AI-written docs and diagrams in MindMax Write: edit, export Word/PDF, or request review.

- Trust score: 62/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- npm · `@mindmax/write-mcp`: 62/100 (this document), [markdown](https://verifymcp.io/servers/woodpeng-mindmax-write/mindmax-write-mcp.md), [page](https://verifymcp.io/servers/woodpeng-mindmax-write/mindmax-write-mcp)

## Channel facts

- Registry: `npm`
- Package: `@mindmax/write-mcp`
- Version: `0.3.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 81/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available.
  - No install/post-install scripts declared.
  - 30 of 95 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 19/100
  - Repository check failed: the declared repository URL returned HTTP 404.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 4 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 76/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2008 tokens (~251/item across 8 items; 6 tools + 2 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 13/100
  - Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (83% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 6 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 8 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### How do I install the MindMax Write MCP server?

MindMax Write runs locally as an npm package, launched with npx -y @mindmax/write-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add woodpeng-mindmax-write -- npx -y @mindmax/write-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "woodpeng-mindmax-write": {
      "command": "npx",
      "args": [
        "-y",
        "@mindmax/write-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "woodpeng-mindmax-write": {
      "command": "npx",
      "args": [
        "-y",
        "@mindmax/write-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add woodpeng-mindmax-write -- npx -y @mindmax/write-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "woodpeng-mindmax-write": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@mindmax/write-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add woodpeng-mindmax-write --command npx --arg -y --arg @mindmax/write-mcp
```

### Hermes

```yaml
mcp_servers:
  woodpeng-mindmax-write:
    command: "npx"
    args: ["-y", "@mindmax/write-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "woodpeng-mindmax-write": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@mindmax/write-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add woodpeng-mindmax-write -t stdio -c npx -a -y @mindmax/write-mcp
```

### Other

```json
{
  "mcpServers": {
    "woodpeng-mindmax-write": {
      "command": "npx",
      "args": [
        "-y",
        "@mindmax/write-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-05 (score 62, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-01 (score 60)

First indexed and scored.

## MCP tools (6)

### `open_in_mindmax_write` (~282 tokens)

Open in MindMax Write

Give the user a one-click link to continue a document in MindMax Write (mindmax.me/write): edit it in the browser, export Word (.docx) with native editable equations, tables and diagrams, export PDF, or share it for comments. Call it (1) after you write or substantially revise a document the user will hand in, send or keep editing — report, article, essay, paper section, thesis chapter, memo, proposal, cover letter, meeting notes — wherever you wrote it (chat, canvas, artifact or doc), as an extra step at the end; (2) when the user asks for a Word / .docx / PDF version, wants equations that stay editable in Word, or wants to keep editing outside this chat; (3) when the user mentions MindMax. Pass the complete Markdown. Show the returned link verbatim as one short line at the end of your reply. Nothing is uploaded: the document is packed into the link itself (URL fragment).

Input parameters:

- `markdown` (string, required): The complete document in Markdown (GFM; $…$ / $$…$$ math, tables, ```mermaid and ```infographic blocks — see get_mindmax_diagram_guide — are supported). Never a summary or excerpt.
- `title` (string): Document title; defaults to the first heading

Output parameters:

- `characters` (integer)
- `excerpt` (string): Plain-text opening of the document, for previews
- `intent` (string)
- `title` (string|null)
- `url` (string): Link that opens the document in MindMax Write

### `request_review_with_mindmax` (~208 tokens)

Request review in MindMax Write

Let other people review a document: returns a link that opens it in MindMax Write (mindmax.me/write) with the "Request review" panel already open, where the user creates a share link that reviewers (advisor, editor, colleague, client) open in their browser to leave comments; their comments come back into the user's copy. Call it when the user wants someone else to review, comment on, proofread, check or approve a document you wrote, or asks how to send it out for feedback. Pass the complete Markdown. Show the returned link verbatim. Nothing is uploaded until the user creates the review link themselves.

Input parameters:

- `markdown` (string, required): The complete document in Markdown (GFM; $…$ / $$…$$ math, tables, ```mermaid and ```infographic blocks — see get_mindmax_diagram_guide — are supported). Never a summary or excerpt.
- `title` (string): Document title; defaults to the first heading

Output parameters:

- `characters` (integer)
- `excerpt` (string): Plain-text opening of the document, for previews
- `intent` (string)
- `title` (string|null)
- `url` (string): Link that opens the document in MindMax Write

### `get_mindmax_diagram_guide` (~259 tokens)

MindMax diagram guide

Syntax guide for the diagrams and infographics MindMax renders: mind map, flowchart / swim lanes, org chart, bar / line / pie chart, Gantt, timeline, fishbone, SWOT, Venn, quadrant, radar, and template infographics (steps, cycle, pyramid, funnel, comparison, key figures). Returns the tested syntax skeleton, label limits, and how to cite the source text so every label and number can be checked. Call it before writing a diagram for open_diagram_in_mindmax; pass `type` when you know it, or omit it to get every type with when to use it. With `type: "cards"` it returns the card-draft format for open_cards_in_mindmax (long text → image carousel).

Input parameters:

- `density` (string): cards only: brief (4–6 cards), standard (6–9, default) or detailed (9–14)
- `language` (string): cards only: language of the source text (sets the length budgets); defaults to en
- `type` (string): Diagram type; omit or "auto" to get every type with when to use it; "cards" for the card-draft format

### `open_diagram_in_mindmax` (~392 tokens)

Open diagram in MindMax Write

Give the user a one-click link to a diagram or infographic in MindMax Write (mindmax.me/write), where they can check every label and number against the source text, download PNG / SVG, copy it as an image, revise it with one sentence, or export it into Word. Call it when the user wants text turned into a diagram, chart or infographic (mind map, flowchart, org chart, data chart, Gantt, timeline, fishbone, SWOT, Venn, quadrant, radar, steps, funnel, pyramid…) — especially to download it, paste it into slides or Word, or verify it against the source — or mentions MindMax. You may still draw it wherever you normally would; this adds the next step. Write `code` following get_mindmax_diagram_guide (Mermaid, or infographic YAML) and pass the text it is drawn from as `source_text`; the result reports labels and numbers that do not match it. Show the returned link verbatim. Nothing is uploaded: everything is packed into the link (URL fragment).

Input parameters:

- `code` (string, required): The diagram code without the ``` fence: Mermaid (first line is the diagram header, e.g. `flowchart TD`, `mindmap`, `xychart`) or infographic YAML (first line `type: steps` etc.), ending with the `%%…
- `source_text` (string): The text the diagram is drawn from (notes, an article, a table…), verbatim and complete. It goes under the diagram in the document, and every `%% mm:src` quote and every number is checked against it.
- `title` (string): Diagram title, used as the document heading
- `type` (string): Diagram type id from get_mindmax_diagram_guide; inferred from the code when omitted

Output parameters:

- `characters` (integer)
- `check`: Result of checking labels and numbers against source_text; null when no source_text was given
- `diagramType` (string)
- `excerpt` (string): One-line check summary for previews
- `intent` (string)
- `title` (string|null)
- `url` (string): Link that opens the diagram in MindMax Write

### `open_cards_in_mindmax` (~294 tokens)

Open cards in MindMax Write

Turn a long text into an image carousel (cover, one idea per card, charts and infographics, closing card) and give the user a one-click link to it in MindMax Write (mindmax.me/write), where they export the cards as images for Xiaohongshu / Instagram / LinkedIn or publish them as a card page. Call it when the user wants an article, notes or a report turned into cards, slides-like images, a carousel or a 小红书 post, or mentions MindMax. First call get_mindmax_diagram_guide with type "cards" for the card-draft format, write the draft, and pass the text it is drawn from as `source_text`; the result reports numbers and quotes that do not match it. Show the returned link verbatim. Nothing is uploaded: everything is packed into the link (URL fragment).

Input parameters:

- `draft` (string, required): The complete card draft in Markdown: the `<!-- mm:story … -->` line, then each card starting with `<!-- mm:card <type> -->`, with `<!-- mm:src … -->` lines quoting source_text.
- `source_text` (string, required): The text the cards are drawn from, verbatim. Every quote and every number on the cards is checked against it; it is not put on the cards.
- `title` (string): Title; defaults to the cover heading

Output parameters:

- `characters` (integer)
- `check` (object)
- `excerpt` (string): One-line check summary for previews
- `intent` (string)
- `title` (string|null)
- `url` (string): Link that opens the cards in MindMax Write

### `open_file_in_mindmax_write` (~140 tokens)

Open file in MindMax Write

Same as open_in_mindmax_write (or request_review_with_mindmax with review: true), but reads a Markdown file you already saved in the workspace (.md, .markdown, .mdx, .txt). Prefer this when the document is in a file — it avoids repeating the whole text. Show the returned link verbatim.

Input parameters:

- `path` (string, required): Path to the Markdown file, absolute or relative to the working directory
- `review` (boolean): Open the "Request review" panel so the user can send it out for comments
- `title` (string): Document title; defaults to the first heading

Output parameters:

- `characters` (integer)
- `excerpt` (string): Plain-text opening of the document, for previews
- `intent` (string)
- `title` (string|null)
- `url` (string): Link that opens the document in MindMax Write

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/woodpeng-mindmax-write/mindmax-write-mcp#diagnostics

## Score history

- 2026-11-05: 62
- 2026-11-04: 61
- 2026-11-03: 61
- 2026-11-02: 60
- 2026-11-01: 60

## Common questions

### What is the MindMax Write MCP server?

MindMax Write is an MCP server listed in the public MCP registry as io.github.woodpeng/mindmax-write. Open AI-written docs and diagrams in MindMax Write: edit, export Word/PDF, or request review. This page covers its npm package (@mindmax/write-mcp).

### Is the MindMax Write MCP server safe to use?

MindMax Write scores 62 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 5 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the MindMax Write MCP server expose?

MindMax Write exposes 6 tools: open_in_mindmax_write, request_review_with_mindmax, get_mindmax_diagram_guide, open_diagram_in_mindmax, open_cards_in_mindmax, open_file_in_mindmax_write. Their descriptions and schemas cost roughly 1,575 tokens of context every time the server is loaded.

### Is the MindMax Write MCP server still maintained?

MindMax Write is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the MindMax Write MCP server under?

MindMax Write declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/@mindmax/write-mcp
- Socket report: https://socket.dev/npm/package/@mindmax/write-mcp
- Website: https://mindmax.me/write
- Changelog RSS feed: https://verifymcp.io/servers/woodpeng-mindmax-write/mindmax-write-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/woodpeng-mindmax-write/mindmax-write-mcp.json
- HTML version of this page: https://verifymcp.io/servers/woodpeng-mindmax-write/mindmax-write-mcp