• Task
  • Version · 6.0
  • Create

Configure the Liquibase AI Changelog Generator in Claude Code

Last updated: August 11, 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 AI Changelog Generator JAR file from Maven Central or follow the installation guide, 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.

  • Optional: Obtain the Liquibase AI Changelog Generator Docker image

  • Optional: Install Docker Desktop if you plan to use the Docker image.

Procedure

1

Confirm the server starts

From your terminal, run one of the following commands.

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

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're using Java and see an error, confirm that java -version returns 17 or higher.

2

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
3

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
4

Add the MCP server configuration

Paste one of the following configurations 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.

Be sure to:

  • 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.

  • Ensure you have obtained the Liquibase AI Changelog Generator Docker image before using this option.

Save the file and close the editor.

5

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
6

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.

7

Verify the connection

At the Claude Code prompt, run:

/mcp

liquibase-mcp should appear with status connected.

8

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.

PreviousConfigure it in Claude DesktopNextOrganize changes by object