# IWE (iwe.md)

> IWE (iwe.md) is an open-source MCP server for knowledge and memory. Give agents search, read, write and refactor access to a folder of linked markdown notes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, self-hosted
- **Website:** https://iwe.md/docs/agentic/mcp/
- **Repository:** https://github.com/iwe-org/iwe
- **MCP Registry name:** io.github.iwe-org/iwe
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/iwe-iwe-md
