# IWE

> Your Markdown notes as your agent's memory: it finds, reads, writes and reorganizes linked notes in a folder you own.

IWE turns a folder of linked Markdown notes into memory you and your agent share. Its MCP server lets your agent search your notes, read them with their linked context, save decisions and lessons as new notes, and reorganize them. Every note stays a plain Markdown file you can open, edit or keep in git.

What you can do with it
- Find notes by fuzzy search, full-text search or how they link to each other
- Read a note together with the notes it includes or that link to it, within a size budget
- Create, replace and delete notes, with references cleaned up when a note is deleted
- Rename a note and update every link to it, pull a section out into its own note, or inline one back
- Run structured queries and bulk edits over frontmatter and blocks
- Get stats on your notes, including orphan pages and broken links

How it connects
It runs on your machine with npx -y @iwe-org/mcp and works on the Markdown files in the folder it starts in, so set its working directory to your notes folder (in Claude Code, that's the project you open). No account is needed. An optional .iwe/config.toml in that folder changes how it behaves; the IWE CLI's iwe init creates one.

Good to know
- Every write and refactoring tool has a dry run, so your agent can preview a change first.
- It picks up edits you make in your own editor without a restart.
- The same notes also work with IWE's CLI, its editor support for Neovim, Helix, VS Code and Zed, its Claude Code plugin and the iWe app for Mac.

- Type: Plugin
- Made by: iwe-org
- Category: AI & agents
- Formats: Local MCP
- Version: 0.29.1
- Website: https://iwe.md
- Source: https://github.com/iwe-org/iwe
- Page: https://pluginboard.ai/plugins/iwe

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### Claude

Add to claude_desktop_config.json:

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

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22iwe%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40iwe-org%2Fmcp%400.29.1%22%5D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"iwe","command":"npx","args":["-y","@iwe-org/mcp@0.29.1"]}'
```

Copilot CLI:

```shell
copilot mcp add iwe -- npx -y @iwe-org/mcp@0.29.1
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=iwe&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBpd2Utb3JnL21jcEAwLjI5LjEiXX0%3D

Add to .cursor/mcp.json:

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

### Claude Code

Run in your terminal:

```shell
claude mcp add iwe -- npx -y @iwe-org/mcp@0.29.1
```

### Codex

Run in your terminal:

```shell
codex mcp add iwe -- npx -y @iwe-org/mcp@0.29.1
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

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

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add iwe npx -y @iwe-org/mcp@0.29.1
```

### OpenClaw

In a terminal: Run openclaw mcp add iwe --command npx, with --arg before each argument (-y @iwe-org/mcp@0.29.1) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add iwe -- npx -y @iwe-org/mcp@0.29.1
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

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

---
From Pluginboard (https://pluginboard.ai).