| name | mindm-mindmap |
| description | High-level MindManager mindmap operations via the mindm-mindmap CLI or python -m mindmap.actions. Use when a map must be read (mindmap, selection, grounding info), serialized to Mermaid, or created from Mermaid. |
| version | 1.0.0 |
| requires | ["mindm"] |
| platforms | ["macos","windows"] |
Mindm Mindmap
Overview
Use the mindm-mindmap CLI to query the current MindManager map or create a new
map from Mermaid. This skill targets high-level map operations that mirror the
MCP server capabilities.
Quick start
Get the current mindmap as JSON:
uvx --from mindm mindm-mindmap get-mindmap --mode content
Get the current selection:
mindm-mindmap get-selection --mode content
Get grounding information:
mindm-mindmap get-grounding-information --mode content
Serialize to Mermaid:
mindm-mindmap serialize-mermaid
mindm-mindmap serialize-mermaid --mode full --id-only
Create a map from Mermaid:
mindm-mindmap create-from-mermaid --input /tmp/map.mmd
Create a map from Mermaid (full metadata or simplified indentation).
The CLI auto-detects the format.
Round-trip test (serialize → create):
mindm-mindmap serialize-mermaid --mode full | mindm-mindmap create-from-mermaid
Notes
- Keep MindManager open with the target map active before running the CLI.
- For macOS, use --macos-access applescript (default) or appscript.
- For full flag details, read references/cli.md.
- For full Mermaid metadata (notes, links, icons, tags), read references/mermaid.md.
- JSON responses return the raw data for the command. Errors return
{"error": "...", "message": "..."}.
Troubleshooting
| Problem | Solution |
|---|
| "No active document" error | Open a map in MindManager before running the CLI |
| Empty response or timeout | Ensure MindManager is responsive (not showing a modal dialog) |
| Permission denied (macOS) | Grant Accessibility permissions to Terminal/IDE in System Settings → Privacy & Security |
appscript import error | Install with pip install appscript or use --macos-access applescript |
| Mermaid parse error | Check syntax; use --mode full output as reference for valid format |
| Icons not appearing | Verify stock icon index exists (see references/mermaid.md) |
