Automox MCP Server — Claude Code MCP server: manage and install
Connect an AI assistant to Automox to manage devices, patches, and policies with natural-language requests.
claude mcp add --env AUTOMOX_API_KEY=<AUTOMOX_API_KEY> --env AUTOMOX_ACCOUNT_UUID=<AUTOMOX_ACCOUNT_UUID> --env AUTOMOX_ORG_ID=<AUTOMOX_ORG_ID> --transport stdio automox-mcp-server -- uvx automox-mcpWhat Automox MCP Server does
Automox MCP Server connects an AI assistant with an Automox environment. It can inspect devices, check compliance, run policies, and work with patch operations through conversational requests.
The self-hosted server runs with uvx automox-mcp. Its setup requires AUTOMOX_API_KEY and AUTOMOX_ACCOUNT_UUID; adding AUTOMOX_ORG_ID is recommended for organization context. The server can be used with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and the other listed MCP clients.
An organization-scoped key is the safer choice for search tools: a global key can produce 403 in some organizations even when other reads work. A hosted option is available at https://console.automox.com/api/mcp, while the local setup remains available for clients using a local MCP process.
What it helps with
- manage Automox devices from an AI chat
- check patch readiness across an organization
- run Automox policies from a prompt
- inspect compliance and pending actions
Example prompts for the agent
- Check which Automox devices need patches.
- Show the current compliance state and pending actions.
- Run the required Automox policy for this organization.
How to install Automox MCP Server
Platform CLI
claude mcp add --env AUTOMOX_API_KEY=<AUTOMOX_API_KEY> --env AUTOMOX_ACCOUNT_UUID=<AUTOMOX_ACCOUNT_UUID> --env AUTOMOX_ORG_ID=<AUTOMOX_ORG_ID> --transport stdio automox-mcp-server -- uvx automox-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from automox-mcp <command>
Platform CLI
codex mcp add automox-mcp-server --env AUTOMOX_API_KEY=<AUTOMOX_API_KEY> --env AUTOMOX_ACCOUNT_UUID=<AUTOMOX_ACCOUNT_UUID> --env AUTOMOX_ORG_ID=<AUTOMOX_ORG_ID> -- uvx automox-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from automox-mcp <command>
Config file
{
"mcpServers": {
"automox-mcp-server": {
"command": "uvx",
"args": [
"automox-mcp"
],
"env": {
"AUTOMOX_API_KEY": "<AUTOMOX_API_KEY>",
"AUTOMOX_ACCOUNT_UUID": "<AUTOMOX_ACCOUNT_UUID>",
"AUTOMOX_ORG_ID": "<AUTOMOX_ORG_ID>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from automox-mcp <command>
Config file
{
"servers": {
"automox-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"automox-mcp"
],
"env": {
"AUTOMOX_API_KEY": "<AUTOMOX_API_KEY>",
"AUTOMOX_ACCOUNT_UUID": "<AUTOMOX_ACCOUNT_UUID>",
"AUTOMOX_ORG_ID": "<AUTOMOX_ORG_ID>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from automox-mcp <command>
Platform CLI
gemini mcp add -e AUTOMOX_API_KEY=<AUTOMOX_API_KEY> -e AUTOMOX_ACCOUNT_UUID=<AUTOMOX_ACCOUNT_UUID> -e AUTOMOX_ORG_ID=<AUTOMOX_ORG_ID> automox-mcp-server uvx automox-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from automox-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Automox MCP Server
How do I install Automox MCP Server in Claude Code?
Run claude mcp add automox-mcp -e AUTOMOX_API_KEY=<AUTOMOX_API_KEY> -e AUTOMOX_ACCOUNT_UUID=<AUTOMOX_ACCOUNT_UUID> -- uvx automox-mcp.
What does Automox MCP Server do?
It connects an AI assistant to Automox so you can manage devices, patches, and policies through natural-language requests.
Which Automox key should I use for search tools?
Use an organization-scoped key. A global key can return 403 for some search tools in certain organizations.
