Log inSubmit server
Erd Editor logo

Erd Editor

Edit ERD Editor diagrams through MCP from coding agents, with live IDE collaboration or direct .erd.json file changes.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Erd Editor

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "erd-editor": {
      "command": "npx",
      "args": [
        "-y",
        "@dineug/erd-editor-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The erd-editor MCP server lets coding agents modify ERD Editor database diagrams through MCP tools. Each editing operation is exposed as its own tool, and changes can appear in an open VS Code, Obsidian, or JetBrains editor. Without a connected editor, it updates the diagram file on disk instead. Use it when an agent needs to create or revise schema structures alongside a visual ERD.

Use cases

  • Create database tables and relationships from an agent conversation
  • Revise an open ERD diagram while reviewing it in an IDE
  • Apply schema changes directly to an .erd.json file
  • Inspect a diagram when workspace trust blocks agent edits

Key features

  • One MCP tool per editing operation
  • Live collaboration with open ERD Editor diagrams
  • Direct .erd.json file editing
  • Agent-specific undo for connected editor changes
  • Read-only behavior for untrusted or disconnected workspaces

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1.7kStargazers on the source repository.
npm downloads800Package downloads in the last 30 days.
Last commitTodayMost recent push to the default branch.

How Erd Editor works

What erd-editor MCP server does

The erd-editor MCP server connects coding agents to ERD Editor diagrams. It exposes one MCP tool for each editing operation, allowing an agent to make structured changes to a database schema rather than only writing text into a file.

The server works with ERD Editor's .erd.json document format and can operate in two modes. When a supported editor has the diagram open and its connection is enabled, the agent joins that diagram as another collaborator. When no editor is connected, the server works directly with the diagram file in the project folder.

This is a fit for workflows where a developer wants an agent to change tables, columns, relationships, or other ERD content while inspecting the result on a canvas.

How it works

An MCP client starts the server over standard input and output. The agent then receives the available editing operations as MCP tools. In a connected VS Code, Obsidian, or JetBrains environment, the server participates in the editor's collaboration channel, so edits are reflected in the open diagram. The connected editor keeps the agent's changes in the same editing workflow, and its undo behavior can revert the agent's own changes.

With no editor attached, the server edits the .erd.json file on disk. An editor that has disabled its connection, or a workspace or project that is not trusted, permits reading but rejects changes. This provides a read-only path for agent access in those situations.

Setup and configuration

Node.js 22.12 or newer is required. Install the server from the project directory with the package published as @dineug/erd-editor-mcp.

For Claude Code, register it with:

Terminal
claude mcp add --transport stdio erd-editor -- npx -y @dineug/erd-editor-mcp

For Codex, use:

sh
codex mcp add erd-editor -- npx -y @dineug/erd-editor-mcp

The same package can be configured in other MCP clients that support a standard stdio server. The diagram can be held by the VS Code extension, the Obsidian plugin, or the JetBrains plugin; otherwise, place the target .erd.json file in the project directory.

Tools and capabilities

  • Provides one MCP tool for each ERD editing operation.
  • Lets agents edit diagrams displayed in VS Code, Obsidian, or JetBrains IDEs.
  • Modifies .erd.json files directly when no editor is connected.
  • Supports agent participation in an open diagram as a live collaborator.
  • Preserves agent-specific undo behavior in a connected editor.
  • Allows agents to read diagrams when editor connections or workspace trust prevent modifications.

Limitations and notes

The server requires Node.js 22.12 or later. Editing is refused when an editor has disabled its connection or when the workspace or project is untrusted, although reading remains available. Live editing depends on an ERD Editor instance being open in a supported host; without one, the server works against the file on disk instead.

The MCP package is intended for the ERD Editor ecosystem. Its visual editing hosts include the web app, Google Drive, VS Code, JetBrains IDEs, and Obsidian, but the agent connection described here specifically uses the MCP server and the editor integrations that expose a diagram to it.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Erd Editor

erd-editor is an MCP server that connects coding agents to ERD Editor diagrams and exposes one MCP tool for each schema-editing operation. It can work with an open VS Code, Obsidian, or JetBrains diagram, or modify an .erd.json file on disk when no editor is connected.

Install it with npx from your project folder and register it as a stdio MCP server. Claude Code uses `claude mcp add --transport stdio erd-editor -- npx -y @dineug/erd-editor-mcp`; Codex uses `codex mcp add erd-editor -- npx -y @dineug/erd-editor-mcp`. Node.js 22.12 or newer is required.

Yes, it edits the `.erd.json` file on disk when no ERD Editor instance is connected. With an open supported editor, the agent instead joins the diagram as a collaborator and its changes appear in the visual editor.

No, an untrusted workspace or project allows reading but refuses edits. The same read-only behavior applies when an editor has its connection turned off.

VS Code, Obsidian, and JetBrains IDEs can hold the diagram while the agent connects through MCP. The server can also work without one of these editors by changing an `.erd.json` file directly.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewErd Editor AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/erd-editor?style=directory)](https://allmcps.com/mcp/erd-editor)
HTML Embed
<a href="https://allmcps.com/mcp/erd-editor"><img src="https://allmcps.com/api/badge/erd-editor?style=directory" alt="Erd Editor on AllMCPs" /></a>