IWE (iwe.md)
Give agents search, read, write and refactor access to a folder of linked markdown notes
- 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/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"iwe": {
"command": "npx",
"args": [
"-y",
"@iwe-org/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"iwe": {
"command": "npx",
"args": [
"-y",
"@iwe-org/mcp"
]
}
}
}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)

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Claude Code Ultimate Guide
MCP serverMCP 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

Nautilus Compass Memory
MCP serverLocal-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

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools