Warcraft 3 MCP Server

Edit your Warcraft III maps by just talking to Claude.

This is an MCP server that connects Claude to your Warcraft III .w3x / .w3m map files. Once it's set up, you can say things like:

"Add a footman for Player 1 in the middle of the map." "Double the hit points of every grunt." "Add a trigger that spawns 5 wolves every 30 seconds, then open the map in the editor."

…and Claude makes the change directly in your map file.

How it works in one line: Warcraft's World Editor has no plugin/automation system, so this edits the map file directly. Your change is really in the map — open it in the World Editor or play it and it's there.

Install (5 minutes)

Step 1 — Install Node.js

Download and install Node.js 18 or newer from nodejs.org. (To check if you already have it, open a terminal and run node --version.)

Step 2 — Download this project and build it

Open a terminal (Command Prompt, PowerShell, or Terminal) and run:

git clone https://github.com/YElwiddi/warcraft-3-mcp-server.git
cd warcraft-3-mcp-server
npm install
npm run build

That's it — the server is now built into the dist folder.

Step 3 — Connect it to Claude

Pick whichever you use:

Claude Code (the CLI) — run this one command (use the full path to the folder you just built):

claude mcp add wc3 --scope user -- node "/full/path/to/warcraft-3-mcp-server/dist/index.js"

Claude Desktop (the app) — open Settings → Developer → Edit Config, and add a wc3 entry under mcpServers (keep any servers you already have):

{
  "mcpServers": {
    "wc3": {
      "command": "node",
      "args": ["C:/full/path/to/warcraft-3-mcp-server/dist/index.js"]
    }
  }
}

Step 4 — Restart Claude

Close and reopen Claude Code / Claude Desktop so it loads the new tools. You're done!

💡 Tip: Use forward slashes / in the path even on Windows, e.g. C:/Users/You/warcraft-3-mcp-server/dist/index.js.

Try it

Just ask Claude in plain English and give it the full path to your map. For example:

"Use wc3 to give me an overview of `C:\Users\Me\Desktop\MyMap.w3x`."

By default, edits are saved to a copy next to your map (MyMap.edited.w3x) so your original is safe. Tell Claude "overwrite the original" if you want it to edit the file in place.

What Claude can do (the tools)

Look at a map

Change a map

Create new things

See your change

Good to know

• Your originals are safe — edits save to a .edited copy unless you ask to overwrite.
• Triggers / new logic: wc3_set_durable_script stores your JASS/Lua in war3map.wct (the

editor's own trigger storage) and mirrors it into the map script — so it runs immediately and survives editor re-saves, appearing in the Trigger Editor where you can edit it later. For an auto-running trigger, create one custom-text trigger in the editor first (e.g. name it MCPDurable) and save once; the header slot (slot:"header") needs no setup.

• Very large or protected maps may have a few parts that can't be read; Claude will tell you

which part and keep working on the rest.

• This is not affiliated with Blizzard Entertainment. Warcraft III is a trademark of

Blizzard. This tool only reads/writes your own map files.

License

MIT — free and open source. Do whatever you like with it.