
IWE MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude and other agents search, read and edit a folder of markdown notes as a linked knowledge base.
IWE turns a folder of markdown files into a graph of linked notes, and its MCP server lets your assistant find, read, create, rewrite and reorganize those notes. It runs on your computer over standard input and output, and works on the folder it is started in. It can delete and overwrite notes, so keep the folder in git or backed up.
Good for
- People who keep notes in markdown files and want an assistant to use them as memory
- Developers who store project decisions and docs as linked notes
- Writers who want an assistant to reorganize notes without breaking links
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install IWE MCP
Claude Code
- 1
Copy this prompt.
Add the IWE MCP server to Claude Code. Run this command: claude mcp add iwe -- npx -y @iwe-org/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js, Run it from your notes folder (it reads its working directory).
IWE works on the folder it is started in and has no path option, so launch it from your notes folder (in a terminal: cd ~/notes, then start the client). Apps that start servers from their own folder, such as Claude Desktop, will not find your notes with the plain command; use the shell variant on the Claude Desktop tab, which changes into the folder first. The npm package README gives only the generic mcpServers command, so per-app wrappers here are adapted by PlugWiki.
Built from the package data we hold. Not yet tested by us. Source.
Tools
Searches your notes with fuzzy matching and link filters
Finds notes by fuzzy text match, and can limit results by how they link to other notes.
Try: “Find my notes about authentication.”
Files ·
iwe_findReads notes along with the notes they link to
Fetches notes and expands outward through links to the depth you set, with limits on how many notes come back. Can also search by keywords first.
Try: “Read my login-flow note and the notes it links to.”
Files ·
iwe_retrieveShows how your notes are organized
Returns the hierarchy of notes as a tree, optionally limited to part of it.
Try: “Show me the outline of my notes.”
Files ·
iwe_treeReports note counts and broken links
Returns statistics about the whole note collection, plus broken links, or details for one note including near-duplicates.
Try: “Are there broken links in my notes?”
Files ·
iwe_statsFlattens a note and the notes it embeds into one document
Expands embedded block references so you can read the whole thing as a single flat document.
Try: “Squash my project-plan note into one document.”
Files ·
iwe_squashRuns an advanced query over your notes, including bulk edits
Runs a find, count, update or delete operation written in IWE's query language. Updates and deletes must declare what they expect to change, or they are refused. A preview mode is available.
Try: “Count notes tagged "draft" and list their keys.”
Delete ·
iwe_queryCreates a note
Writes a new markdown note at a key you choose. By default it fails if that key already exists.
Try: “Create a note people/ada about Ada Lovelace.”
Write ·
iwe_createReplaces the whole content of a note
Overwrites an existing note with the new text you give it. Has a preview mode.
Try: “Rewrite my meeting note with this summary.”
Write ·
iwe_updateDeletes a note and removes links to it
Deletes a note and cleans up references to it in other notes. Has a preview mode.
Try: “Delete the obsolete draft note.”
Delete ·
iwe_deleteRenames a note and fixes links to it
Changes a note's key and updates every link that points to it.
Try: “Rename "auth" to "authentication".”
Write ·
iwe_renameMoves a section into its own note
Pulls a section out of a note into a new one and leaves a reference behind.
Try: “Extract the pricing section into its own note.”
Write ·
iwe_extractReplaces a reference with the content it points to
Puts the referenced note's content directly into the note that referenced it.
Try: “Inline the glossary reference into this note.”
Write ·
iwe_inlineReformats all notes consistently
Rewrites all documents so their formatting is consistent.
Try: “Normalize formatting across my notes.”
Write ·
iwe_normalizeAttaches a note to a target using configured actions
Adds a note to another place in your collection using the actions defined in your IWE configuration.
Try: “Attach this note to my weekly log.”
Write ·
iwe_attach
From the official docs
Permissions
high risk · 3 things to watch
High risk
The assistant can overwrite, rename and delete notes in the folder where it runs. Back the folder up or keep it in git, and preview changes first.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can delete and overwrite your notes
The delete, update, rename and bulk query tools change or remove note files in the folder it runs in. Keep the folder in git or backed up, and use the preview option first. iwe.md
Bulk edits reach many files at once
The query tool and the formatting tool can rewrite many notes in one call. Updates must declare what they expect to change, but check the preview before applying. iwe.md
The optional HTTP mode has no sign-in
If you run it over HTTP it listens on 127.0.0.1 by default and speaks plain HTTP with no authentication. Do not bind it to 0.0.0.0 without a proxy in front. iwe.md
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. The write and refactor tools have a dry-run option that previews changes. |
|---|---|
| Sign-in and keys | No account or key. The server works on the markdown files in its working directory. |
Questions
Is IWE official?
Yes. This is the MCP server of the IWE project itself, run from its own repository by the team behind IWE.
Which folder does it work on?
The folder it is started in; it has no path option. Start your client from the notes folder. Claude Desktop starts servers from its own folder, so use the shell variant on its install tab, which changes into your notes folder first.
Does it need an API key or account?
No. It runs on your computer and reads the markdown files in its working directory.
Can it delete my notes?
Yes. It can delete notes and clean up links to them, and it can overwrite note content. The write tools offer a dry-run preview.
Can I run it read-only?
There is no read-only mode in the docs. Keep the folder in git so you can undo changes.
Does it send my notes anywhere?
The docs describe a local server. Notes reach your AI model through the assistant you connect, the same as any file it reads.
What file format does it use?
Plain markdown files in a folder, with optional frontmatter. An optional .iwe/config.toml in the folder customizes behavior.
How do I add it to Claude Code?
Use the Claude Code tab in the install box above, and run it in the notes folder.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
@iwe-org/mcp- Registry
- npm
- Transport
- stdio, Streamable HTTP
- Auth
- None
- Version
- 0.29.3
- License
- Apache-2.0
- Last commit
- Oct 29, 2026
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- www.npmjs.com · npmjs.com
- iwe.md · iwe.md