PlugWiki
IWE logo

IWE MCP Server: Setup for Claude, Cursor and Other Apps

OfficialLocal
Getnpm@iwe-org/mcpiwe-org/iwe

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.

Install IWE MCP

Claude Code

  1. 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. 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_find

  • Reads 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_retrieve

  • Shows 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_tree

  • Reports 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_stats

  • Flattens 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_squash

  • Runs 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_query

  • Creates 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_create

  • Replaces 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_update

  • Deletes 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_delete

  • Renames 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_rename

  • Moves 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_extract

  • Replaces 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_inline

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-onlyNo read-only mode is documented. The write and refactor tools have a dry-run option that previews changes.
Sign-in and keysNo 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

WebsiteGitHubnpmOfficial 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 2
  1. www.npmjs.com · npmjs.com
  2. iwe.md · iwe.md

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.