README

Unolia CLI is a command line interface for managing your DNS records across different providers. It uses Unolia API to unify your provider under the same API. Check out unolia.com for more information.

Currently supported providers:

Installation

Current installation requires you to have PHP and Composer installed on your computer. After that, it's as simple as that:

composer global require unolia/unolia-cli

Or run it without installing globally via cpx:

cpx unolia/unolia-cli

Connect your accounts

If it's the first time you are using Unolia, add your first providers.

Then you can log in for a 30-day period with this command:

unolia login

If you prefer a longer lifetime, create a token for your user account or one dedicated to your team and use the token as follows:

unolia login --token={TOKEN}

Usage

List information about the current user

unolia me 
unolia teams

List all domains

unolia domain:list

List all records for a domain

unolia domain:records example.com

Add, update and remove records

unolia domain:add example.com mg.example.com MX "10 mxa.eu.mailgun.org"
unolia domain:add example.com mg.example.com MX "10 mxb.eu.mailgun.org"
unolia domain:update {ID} 
unolia domain:remove {ID}

Check DNS records

unolia dig unolia.com TXT
unolia dig unolia.com A

Connect your AI agents (MCP)

Unolia exposes a remote MCP server so AI agents can manage your infrastructure with you. Set it up with:

unolia mcp setup

The command detects the agents installed on your machine (pre-selected in the prompt), lets you choose between a global install (all your projects) or a local one (current directory), and writes the connector into each agent's MCP config.

Supported agents: Claude Code, Cursor, VS Code (Copilot), Codex, Gemini CLI, Junie (JetBrains), Kiro, OpenCode and Amp — plus a manual JSON snippet for any other OAuth-capable client.

No login or token is needed: on first connection the agent opens your browser and you sign in to Unolia (OAuth).

For scripting, skip the prompts with flags:

unolia mcp setup --global --agents=claude,cursor
unolia mcp setup --local --agents=vscode
unolia mcp setup --print   # just print the JSON snippet

Self-hosted or development instances can point the connector elsewhere with the UNOLIA_MCP_URL environment variable (default: https://app.unolia.com/mcp/team).

Upgrade

Installed with composer:

composer global update unolia/unolia-cli

Credits

unolia-cli was created by Eser DENIZ.

License

unolia-cli PHP is licensed under the MIT License. See LICENSE for more information.

unolia / unolia-cli

Maintainers

Package info

Statistics

Security