zenwrite
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
zenwrite
A calm place to write Markdown. Your notes stay plain files in a folder you choose, so Obsidian, Git and every other tool see normal notes.
It is one app that runs three ways:
Standalone web app (PWA): open a folder, write. Installable, works offline, nothing is uploaded.
A zen plugin: zenbot shows it as the opener for
*.mdfiles, and runs its tools.An MCP App: Claude, ChatGPT and any host that supports MCP Apps show it inline or full screen, on a notes folder the server is given.
What it does
Live preview. Markdown shows as it reads: marks (
#,**, links, math) are hidden except on the line or piece the caret touches.$…$and$$…$$math is drawn by KaTeX, loaded only for notes that have math. A click opens a link ([[wiki links]]and.mdlinks open as notes).Alternatives. Select a word, sentence or paragraph and keep several ways to say it; flip between them in place. AI can offer more.
Ghosts. Fade text out without losing it; bring it back any time.
Check. AI proofreading fixes, and marks that only point at weak, long and filler text. Shrink: cuts, least needed first, taken for 10, 20, 30 or 50%, ghosted so nothing is lost.
Notes. A
## Notessection edited in the side panel; Find in notes proposes short notes linking other notes in the folder that help the piece.Versions. One open version at a time (the file). Closing it takes a changelog line and freezes a copy in
.versions/<note>/vN.md. Old versions open read-only and can be branched from.Safe saves. A save names the hash it was based on and is refused if the file changed since: a note changed elsewhere is never overwritten. A new note is written only once it has something past its title.
The note format
Plain Markdown. Alternatives and ghosts live in one comment at the end of the file, anchored to the
text they cover; ## Notes and ## Changelog are ordinary sections. Nothing else is added.
# Title
Body, as it reads.
<!-- zen:alternatives
{"version":1,"groups":[…]}
-->zen:alternatives is the marker's name in the file format. Authors in it are me, ai and
agent (older files say ze and zenbot; they are read as me and agent).
Keys
Alt+L left panel (alternatives, check, ghosts), then its next tab, then closed · Alt+R the same
for the right panel (notes, versions, properties) · Alt+O open a note · Ctrl+S save (it also
saves as you type; in a single-file browser it downloads).
The same four keys act on the tab of the panel opened last:
Tab |
|
|
|
|
alternatives | flip in place | versions of the selection (↑↓, Enter default, type + Enter adds, Esc) | remove the one showing | 🤖 versions |
check | previous / next fix or mark | accept (a mark: done) | reject | check the piece ( |
ghosts | previous / next cut, else ghost | cut it (ghosted) · bring back | keep the words · delete | ghost the selection ( |
notes | proposed notes | keep | dismiss | find in notes ( |
versions | choose | open, read-only | close this version |
Related MCP server: Local Knowledge Desk
Run it standalone
npm ci
npm run build # the PWA is in shells/web/dist: any static server will do
npm run dev # or serve it with hot reloadOpen a folder with Open a folder (Chrome, Edge and other browsers with the File System Access API); versions are kept in that folder. Elsewhere you open one file and save by download, without versions. AI is off in the standalone app for now: the desktop version will connect to the agent you choose (zenbot, Claude Code or Codex).
Install it in zenbot
npm run pack
zen plugins add ./dist/zenwrite-0.1.0.tgzIt asks for files:read and files:write on the notes folder, and ai to ask the host's model
through MCP sampling. No network permission or telemetry: file contents reach the host's model
only when you request AI help. Choose Write as your Markdown opener in Settings → Plugins;
installation does not replace the default. /write <path> opens a note. The host must support
sampling for AI help (see below).
Use it in Claude or ChatGPT
Build it, then add the server to the client's MCP configuration, naming the notes folder:
{ "mcpServers": { "zenwrite": {
"command": "node", "args": ["/path/to/zenwrite/mcp/dist/server.js"],
"env": { "ZEN_PLUGIN_FILES": "/path/to/your/notes" }
} } }Ask for zenwrite_open on a note and the app appears. Without ZEN_PLUGIN_FILES the file tools say
so and refuse. Clients without sampling get "AI isn't available here" from the AI tools
(zenwrite_find_notes still searches when given queries).
Tools
All paths are relative to the notes folder: Markdown only, no .., no absolute paths, no dot
folders (only the plugin's own .versions), no symlinks out.
Tool | |
| shows the app; returns |
|
|
|
|
| atomic; refused (error with |
|
|
| freezes |
|
|
| a new open version from version n (refused while one is open) |
| AI: |
| AI: |
| AI: |
| AI: |
| AI: |
AI tools return {available: false, message} when the client has no sampling. Their instructions
are the skills in skills/writing/ (proofread, marks, shrink, find-notes, changelog),
read at every call: edit one and it applies at once. They hold no personal data; add your own
preferences to them.
Develop
core/ pure TypeScript: the note format, versions, safe saves, AI prompts and parsers, search
ui/ Svelte 5 app (CodeMirror 6): the MCP App (ui/dist/app.html) and the PWA's UI
mcp/ the MCP server (mcp/dist/server.js, plain Node)
shells/web/ the PWA: manifest, service worker, icons
skills/ the AI's instructionsnpm ci && npm run build && npm run check # types + unit tests + the MCP smoke test
npm run e2e # Playwright: the PWA, and the app in a stand-in hostnpm run e2e needs Chromium (npx playwright install chromium).
Storage and AI sit behind two small interfaces in ui/src/lib/ports.ts, so desktop (Tauri) and
mobile (Capacitor) shells can be added without touching the editor.
Licence
MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Hosted MCP server for Obsidian Sync vaults: read, search, edit notes. Not affiliated with Obsidian.
Remote MCP server for notes, tasks, kanban boards and docs - the Slates agentic workspace
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for AI agents to read, write, and organize notes in a local-first, human-in-the-loop note-taking app.2MIT
- FlicenseAqualityBmaintenanceA local MCP server for managing Markdown notes, enabling create, list, read, search, summarize, and delete operations through natural language.61-
- AlicenseAqualityCmaintenanceMCP server for managing a local, domain-agnostic knowledge base using Markdown notes with frontmatter. Enables AI agents to capture, read, search, link, and maintain notes with atomic writes and privacy controls.13MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents read and write access to a folder of Markdown notes, supporting full-text search, reading, listing, and writing notes. It is deliberately small, with no dependencies beyond the MCP SDK, and includes proper path traversal protection.MIT