IWE
About
Knowledge graph MCP server for searching, reading, and refactoring hierarchical markdown documents
Details
- Author
- iwe-org
- Categories
- Productivity, Knowledge Base, Other
Jump to
Setup
Install IWE in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/iwe-org/iwe
Follow the installation instructions in the repository README, then restart your MCP client.
IWE - Memory system for you and your AI agents
Turn your thinking into queryable context
IWE turns a directory of markdown files into a knowledge graph — a connected structure you browse from your editor and your AI queries from the command line. Same files, same links, two interfaces. No cloud, no database, no lock-in. Version everything with git.
IWE is for people who want database-style queries on their notes — "all drafts under this subtree", "every accepted decision in Q1" — without moving them into an actual database. Write inMarkdown, structure with links, give AI agents thetoolsto navigate your knowledge. IWE itself has no built-in AI — it works alongside Claude, Codex, Gemini, and any tool that speaks theModel Context Protocol.
- Plain markdown, full ownership.Your notes are.mdfiles in a local directory. Read them, edit them,git pushthem. Nothing proprietary.
- A graph, not a folder tree.Link notes together and the same note can belong to multiple topics without copying the file. (How linking works)
- IDE features for your editor.Real LSP integration withVS Code,Neovim,Zed, andHelix— search, refactor, rename, autocomplete.
- Structured access for AI agents.CLI toolsand anMCP servergive agents parent context and structural navigation over the same notes you edit by hand — retrieval by structure, not similarity guessing.
- Speaks OKF.AnOpen Knowledge Formatbundle is markdown with YAML frontmatter — the format IWE already manages.iwe init --okfscaffolds a conformant bundle,iwe schema validatechecks conformance mechanically, andiwe find --filter '{type: …}'queries OKF frontmatter directly.
- Fast.Built in Rust,processes 20,000 files in under a second.
Agents ship with an instructions file — CLAUDE.md, AGENTS.md — and it's tempting to let memory accumulate there too. It doesn't hold. Instructions are rules; memory is what builds up: decisions, corrections, the state of everything in flight. Kept in one flat file, the agent appends, contradictions pile up side by side each looking authoritative, and every session re-reads the whole thing.
IWE stores memory as many small linked documents, so the agent asks instead of re-reading. Most recall is a structured question — what's still open, what did we decide about X, which notes mention this person — answered by a query and one retrieve call that expands the linked context. The rest of the graph stays out of the context window. And because it's markdown in git, the memory is inspectable: open what the agent believes, diff what changed, git-blame when.
IWE treats your notes as a connected structure. You organize them with two types of links:
- Nesting— a link on its own line means "this topic includes that subtopic." Your notes form a tree you can browse and refactor. IWE calls theseinclusion links.
- Cross-references— regular inline links connect notes across topics, creating a web of relationships.
- Multiple parents— the same note can live under several places at once. A "Meditation" note can belong to both "Health" and "Productivity" without duplicating the file.
- Context from parents— when you retrieve a note, IWE can include context from the notes above it in the hierarchy.
This structure makes retrieval powerful — whether you're browsing in your editor or an agent is querying via CLI, ask for a topic and get its full context in a single call.
IWE gives AI agents structured access to your notes through two interfaces: a CLI for scripting and shell-based workflows, and an MCP server for native connection with AI tools. Both expose the same operations — search, retrieve, create, refactor — so you can choose whichever fits your setup.
IWE pairssearch with structure: built-in fuzzy and full-text search finds the entry point, and the graph turns a hit into usable context — parent context, children, cross-references, link-safe refactoring. It also composes cleanly with any external tooling you already use (ripgrep, full-text, vector): whatever finds the note, IWE supplies the context around it.
- Declared scope.A mutation carriesexpectguards stating how many documents and blocks it may touch. The whole update validates before anything is written; a mismatch aborts with the offending blocks named. Over MCP the guards are mandatory — an edit that won't declare its blast radius is refused.
- Schemas.Frontmatter and document structure are validated against per-typedocument schemas— required fields, enums, ISO dates, required sections. A schema-violating MCP write is rejected with the violation named; from the CLI,iwe schema validateruns the same checks on demand.
- Graph hygiene.Mutations surface warnings for what they disturbed — dangling links, orphan pages — andiwe stats similarityflags near-duplicates.
IWE includes a server (iwec) that lets AI tools like Claude Desktop, Cursor, and Windsurf work directly with your notes using theModel Context Protocol. The server watches your files for changes, so edits you make in your editor are reflected immediately.
The CLI lets you (and AI agents) work with your notes from the terminal or in scripts.
Example: preparing context for an AI conversation
iwe find --fuzzy auth iwe retrieve --key authentication --expand-includes 2 iwe tree --key oauth
The full set —new,extract,inline,rename,delete,squash,stats,normalize,exportand more — is in theCLI Reference.
More information:Working with AI·CLI Reference·MCP Server
IWE gives your editor IDE-like features for markdown notes. It works withVS Code,Neovim,Zed,Helix, and any editor that supports the Language Server Protocol (LSP).
- Search— find notes by title or content
- Navigate— go to definition, find references (backlinks)
- Preview— hover over links to see content
- Auto-complete— link suggestions as you type
- Inlay hints— show parent references and link counts
- Extract— pull sections into new notes
- Inline— embed note content back into parent
- Rename— rename files with automatic link updates
- Format— normalize documents, update link titles
- Transform— pipe text through external commands
- Templates— create notes from templates (daily notes, etc.)
- Outline conversion— switch between headers and lists
Or fromconda-forge(community-maintained — thanks,salim-b):
Set up your editor—VS Code·Neovim·Helix·Zed
Connect your AI agent— point it at the MCP server.iwecserves the directory it runs in, so set the working directory to your notes:
{ "mcpServers": { "iwe": { "command": "iwec", "cwd": "~/notes" } } }
No install needed —npxfetches the server on demand:
{ "mcpServers": { "iwe": { "command": "npx", "args": ["-y", "@iwe-org/mcp"], "cwd": "~/notes" } } }
Or hand the setup to the agent — paste this into Claude Code or any agent with shell access:
Set up IWE for my notes: install it (brew tap iwe-org/iwe && brew install iwe, npm install -g @iwe-org/iwe, or cargo install iwe iwes iwec), run iwe init in my notes directory, then add the iwec MCP server with its working directory set to that folder. Docs: https://iwe.md/docs/agentic/
- Getting Started— Installation and setup
- Usage Guide— Editor features and workflows
- CLI Reference— Command-line tools
- Working with AI— AI agent integration
- MCP Server— Native AI tool integration via Model Context Protocol
- OKF— Open Knowledge Format: scaffold, validate, and query conformant bundles
- Configuration— Settings and customization
- Examples— Example projects and case studies
IWE is open source and community-driven. Join thediscussions, reportissues, or contribute to thedocumentation.
Community:Twitter/X·Reddit·Discussions
Workspace templates:marketing-workspace— campaign memory for a marketing agent ·dev-workspace— project memory for a coding agent. Both ship as conformantOKFv0.2 bundles, validated in CI on every commit.
Agentic skills:iwe-org/skills— agentic AI skills for knowledge graph management. Contributors welcome.
Building on IWE:projects already embed IWE — as an agent-memory backend, as the graph layer of an LLM wiki engine, in research tooling. The practical integration surfaces today are theCLIand theMCP server; theliwelibrary is published but not yet API-stable, so pin your version if you build against it. A declared, stable integration surface is on the roadmap — if you're building on IWE,tell uswhat you depend on, so we know what not to break.
Standalone Obsidian MCP server with semantic search, knowledge graph analytics (PageRank, Louvain, shortest path), and vault editing — no plugin, no REST API, works when Obsidian is closed.
Markdown and Obsidian compatible knowledge graph.
An MCP server for interacting with the YuQue knowledge base, enabling AI assistants to perform operations on documents and information.
NVIDIA AI Developer Stack as Compressed Knowledge Graph (CKG) - 20 domains, 998 notes, agents traverse typed dependency edges instead of scanning docs.
Automated document processing and extraction
Convert files (DOCX, XLSX, PPTX, images), HTML, and Markdown to pixel-perfect PDFs — npx stdio or hosted Streamable HTTP, free API key in one click.
Connect with 10,000+ tools across HRIS, ATS, CRM, Accounting, Calendar, Meeting, Ticketing, and more categories.
Official Notion MCP server for searching, reading, creating, and updating Notion pages, databases, and workspace content from AI agents.
Collaborative word processor you can use with your agent
Connect any AI assistant to Syncro: manage tickets, invoices, customers, assets, and more.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





