Configure the Liquibase AI Changelog Generator in Claude Code

Last updated: May 15, 2026

Both Liquibase XML changesets and formatted SQL come with their own complexity: XML requires precise syntax and schema expertise, while formatted SQL demands learning specific rules and conventions. The Liquibase AI Changelog Generator solves this by letting you describe database changes in natural language and automatically converting them into valid, tested Liquibase changesets. This Model Context Protocol (MCP) server runs locally and integrates with Claude Code CLI, turning conversational requests like “add an email column to the users table” into production-ready changesets.

Powered by Liquibase’s native Java APIs, the server offers nineteen specialized tools that handle everything from basic table operations to complex procedures and sequences. Each generated changeset is automatically validated against an H2 database to catch errors before they reach your production environment, with configurable validation and rollback options to match your workflow. As a standalone executable with 322 comprehensive tests, you can generate validated changesets immediately with no external Liquibase CLI installation required.

Before you begin

Download the liquibase-mcp-changelog-server-0.1.0.jar file and note its full path.
Java 17 or higher is installed and available in the PATH.
Liquibase Secure is installed. Note the full path to the folder that contains the liquibase executable.
Claude Code CLI is installed.

Procedure

Confirm the Server Starts

From your terminal, run the following command.

Be sure to:

Replace your_jar_path with the full path to the JAR file on your machine. For example, /Users/yourname/liquibase-mcp-changelog-server-0.1.0.jar

java -jar your_jar_path

The output will state the server has started successfully:

Liquibase Changelog MCP Server v0.1.0
Starting Liquibase MCP Server...
Liquibase MCP Server started successfully with 19 tools

If you see an error, confirm that java -version returns 17 or higher.

Create a Working Directory

Create a folder where you will run Claude Code. The .mcp.json configuration file must be in the same directory where you launch Claude Code.

mkdir -p ~/liquibase-mcp-workspace

Create the .mcp.json File

Navigate into the directory, create the configuration file, and open it in a text editor.

cd ~/liquibase-mcp-workspace
touch .mcp.json
open .mcp.json

Add the MCP Server Configuration

Paste the following into the file.

Be sure to:

Replace your_jar_path with the full path to the JAR file. For example, /Users/yourname/liquibase-mcp-changelog-server-0.1.0.jar
Replace your_liquibase_home_path with the path to the folder that contains the liquibase executable. For example, /usr/local/bin
Replace your_liquibase_license_key with your Liquibase Secure license key.

{
  "mcpServers": {
    "liquibase-mcp": {
      "command": "java",
      "args": ["-jar", "your_jar_path"],
      "env": {
        "LIQUIBASE_MCP_OUTPUT_FORMAT": "liquibase-xml",
        "LIQUIBASE_MCP_SQL_DATABASE": "postgresql",
        "LIQUIBASE_MCP_INCLUDE_ROLLBACK": "true",
        "LIQUIBASE_MCP_DISABLE_VALIDATION": "false",
        "LIQUIBASE_HOME": "your_liquibase_home_path",
        "LIQUIBASE_LICENSE_KEY": "your_liquibase_license_key"
      }
    }
  }
}

Save the file and close the editor.

Launch Claude Code from Your Working Directory

Claude Code reads .mcp.json only when launched from the directory that contains the file.

cd ~/liquibase-mcp-workspace
claude

Approve the MCP Server

The first time you launch Claude Code with a new .mcp.json, it prompts you to trust the MCP server configuration. Type yes and press Enter.

Verify the Connection

At the Claude Code prompt, run:

/mcp

liquibase-mcp should appear with status connected.

Test the Connection

At the Claude Code prompt, type:

Create a table called orders with id BIGINT and total DECIMAL(10,2)

Claude calls the create_table tool and returns an XML changelog in the terminal.