Skip to content
MCP server

IWE (iwe.md)

Give agents search, read, write and refactor access to a folder of linked markdown notes

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, self-hosted
Runs
Locally
Version
0.33.0
Listing updated
3 days ago

About IWE (iwe.md)

IWE (iwe.md) is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

The server runs in the notes directory it is started in and exposes the same operations as the IWE command line through the iwec binary. Stdio is the default; an HTTP mode listens on 127.0.0.1 port 8000 unless told otherwise, and the docs advise putting a reverse proxy in front for TLS or authentication if you expose it.

Reading tools do fuzzy search with relationship filters, fetch documents with graph expansion, show tree structure, report graph statistics and broken links, and flatten block references. Writing tools create, replace or delete documents. A document's key is its stable identity, and creation takes the whole markdown file verbatim with frontmatter first; if_exists can be set to skip so retries stay idempotent. A query tool applies updates or deletes.

Mutations can return advisory warnings about orphan pages, dangling links and near-duplicate pages, reported once per session. The README presents it as a way to keep an agent's memory in plain notes you can read and correct.

Install

Run in a terminal

claude mcp add iwe -- npx -y @iwe-org/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "iwe": {
      "command": "npx",
      "args": [
        "-y",
        "@iwe-org/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "iwe": {
      "command": "npx",
      "args": [
        "-y",
        "@iwe-org/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "iwe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@iwe-org/mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "iwe": {
      "command": "npx",
      "args": [
        "-y",
        "@iwe-org/mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "iwe": {
      "command": "npx",
      "args": [
        "-y",
        "@iwe-org/mcp"
      ]
    }
  }
}

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

iwe_find
Searches documents with fuzzy matching and relationship filters.
iwe_retrieve
Fetches documents with search seeds and graph expansion.
iwe_tree
Shows hierarchical document structure.
iwe_stats
Returns knowledge graph statistics and broken link reports.
iwe_squash
Expands block references into one flat document.
iwe_create
Creates a document at a key from complete markdown.
iwe_update
Replaces the full content of an existing document.
iwe_delete
Deletes a document and cleans up references.
iwe_query
Applies update or delete operations across documents.

What it does

Fuzzy find with filters
Searches documents and filters by relationships.
Graph retrieval
Fetches documents plus connected context.
Structure and stats
Shows hierarchy, link statistics and broken links.
Verbatim writes
Creates or replaces documents exactly as supplied.
Idempotent creates
if_exists skip makes retries safe.
Link warnings
Flags orphans, dangling links and similar pages.

Good for

  • Use a markdown vault as shared memory between you and an agent
  • Find and refactor linked notes
  • Detect broken links in a knowledge base
  • Let agents create structured person or project notes

Pricing

Open source

Open source; Apache licence badge on the repository

Prices change. Check iwe.md before you buy.

IWE (iwe.md) FAQ

How many tools are there?

14, covering reading, writing, querying and refactoring.

Can it serve over HTTP?

Yes, with --transport http, binding to localhost by default.

Does it block on warnings?

No. Orphan and dangling-link warnings are advisory.

Where does it run?

Against the notes directory where it is started.

Is IWE (iwe.md) free?

Yes. IWE (iwe.md) is open source, so you can use and self-host it for free.

How do I add IWE (iwe.md) to Claude Code?

Run this command in your terminal: claude mcp add iwe -- npx -y @iwe-org/mcp

What are the best alternatives to IWE (iwe.md)?

The closest alternatives to IWE (iwe.md) are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

Alternatives to IWE (iwe.md)

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  5. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools