English Français العربية

changelogai

Official registry Developer tools

Generate changelogs and suggest semver bumps from git history

Source code Website Documentation

What can you do with changelogai?

  • Zero config — auto-detects latest tag, parses conventional commits
  • Smart grouping — categorizes commits into Features, Bug Fixes, Performance, etc.
  • AI mode — rewrites commit messages into clear, user-facing descriptions using Claude
  • Multiple formats — Markdown, JSON, plain text
  • Version bump suggestion — analyzes changes and suggests major/minor/patch
  • Prepend mode — add new releases to the top of existing CHANGELOG.md
  • No dependencies — pure Node.js, works everywhere

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @ura-dev/changelogai
Claude Code 
claude mcp add changelogai -- node -y @ura-dev/changelogai@1.1.3 '<changelogai-mcp>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "changelogai": {
            "command": "node",
            "args": [
                "-y",
                "@ura-dev/changelogai@1.1.3",
                "<changelogai-mcp>"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. changelogai
  2. Install
  3. Quick Start
  4. Features
  5. Options
  6. MCP Server
  7. AI Mode
  8. License

changelogai

Generate professional changelogs from your git history — instantly.

Works out of the box with conventional commits. Optional AI mode uses Claude to rewrite technical commit messages into user-facing release notes.

Install

npm install -g @ura-dev/changelogai

Quick Start

# Run without installing
npx @ura-dev/changelogai

# Generate changelog since last tag
changelogai

# Grouped by category
changelogai --group

# AI-enhanced (requires ANTHROPIC_API_KEY)
changelogai --ai --group

# Write to file
changelogai --group --output CHANGELOG.md

# Prepend new release to existing changelog
changelogai --group --output CHANGELOG.md --prepend

# JSON output for CI/CD
changelogai --format json

# Suggest semver bump
changelogai --version-bump

Features

  • Zero config — auto-detects latest tag, parses conventional commits
  • Smart grouping — categorizes commits into Features, Bug Fixes, Performance, etc.
  • AI mode — rewrites commit messages into clear, user-facing descriptions using Claude
  • Multiple formats — Markdown, JSON, plain text
  • Version bump suggestion — analyzes changes and suggests major/minor/patch
  • Prepend mode — add new releases to the top of existing CHANGELOG.md
  • No dependencies — pure Node.js, works everywhere

Options

FlagDescriptionDefault
--from <ref>Start ref (tag/commit)Latest tag
--to <ref>End refHEAD
--output <file>Write to filestdout
--format <fmt>markdown, json, plainmarkdown
--groupGroup by commit typefalse
--aiAI-enhanced descriptionsfalse
--model <model>Claude model for AI modeclaude-haiku-4-5-20251001
--prependPrepend to existing filefalse
--version-bumpSuggest semver bumpfalse
--repo <path>Git repo path.
--max-commits <n>Max commits to process500

MCP Server

changelogai includes a Model Context Protocol server for AI agents and IDE integrations (Claude Desktop, Cursor, VS Code, etc.).

{
  "mcpServers": {
    "changelogai": {
      "command": "npx",
      "args": ["-y", "-p", "@ura-dev/changelogai", "changelogai-mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "changelogai": {
      "command": "changelogai-mcp"
    }
  }
}
Available Tools
ToolDescription
changelogai_generateGenerate a changelog from git history. Returns markdown, JSON, or plain text.
changelogai_version_bumpAnalyze git commits and suggest next semver bump (major/minor/patch).

AI Mode

Set your Anthropic API key:

export ANTHROPIC_API_KEY=sk-ant-...

Then run with --ai:

changelogai --ai --group --output CHANGELOG.md

AI mode rewrites technical commit messages into clear, user-facing release notes. Uses Claude Haiku by default (fast and cheap — ~$0.001 per changelog).

License

MIT

Frequently asked questions

What is changelogai?

Generate changelogs and suggest semver bumps from git history

How do I install changelogai?

It runs on your machine. In Claude Code: claude mcp add changelogai -- node -y @ura-dev/changelogai@1.1.3 '<changelogai-mcp>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does changelogai need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is changelogai open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains changelogai?

It is published by ura-tools. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.