IBM Maximo — Claude Code MCP server: API and OSLC queries
Wires your AI assistant into IBM Maximo: it finds object structures, shows field schemas, runs OSLC queries and writes records back.
claude mcp add --env MAXIMO_URL=<MAXIMO_URL> --env MAXIMO_API_KEY=<MAXIMO_API_KEY> --env MAXIMO_HOST=<MAXIMO_HOST> --transport stdio ibm-maximo -- npx -y maximo-mcp-serverWhat IBM Maximo does
This Model Context Protocol server hands your assistant a direct line to a Maximo instance. You stop pasting API docs into the chat. Ask about an object structure such as MXWO or MXASSET and you get the exact field names, types and descriptions. Then run an OSLC REST query and look at real rows before any code gets written.
Writes work too. The server creates work orders, assets and service requests, patches an existing record by ID, and fires Maximo business workflows like status changes or approvals. For front ends it helps build tables and dashboards on Carbon Design System.
You need Node.js v18 or higher and a Maximo API key with read access. Grab the OpenAPI schema first: without maximo_openapi.json the offline schema lookup is gone and responses slow down. Credentials live in .env as MAXIMO_URL, MAXIMO_HOST and MAXIMO_API_KEY — keep that file out of version control.
What it helps with
- locate a Maximo object structure and its fields
- test an OSLC query against live data before writing code
- create a work order or asset from the chat
- patch a Maximo record by ID without opening the UI
- build a Carbon Design System table or dashboard
Example prompts for the agent
- List the fields of the MXWO object structure with their types
- Run an OSLC query against MXASSET and show me the first rows
- Create a work order for a pump repair in Maximo
How to install IBM Maximo
Platform CLI
claude mcp add --env MAXIMO_URL=<MAXIMO_URL> --env MAXIMO_API_KEY=<MAXIMO_API_KEY> --env MAXIMO_HOST=<MAXIMO_HOST> --transport stdio ibm-maximo -- npx -y maximo-mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add ibm-maximo --env MAXIMO_URL=<MAXIMO_URL> --env MAXIMO_API_KEY=<MAXIMO_API_KEY> --env MAXIMO_HOST=<MAXIMO_HOST> -- npx -y maximo-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"ibm-maximo": {
"command": "npx",
"args": [
"-y",
"maximo-mcp-server"
],
"env": {
"MAXIMO_URL": "<MAXIMO_URL>",
"MAXIMO_API_KEY": "<MAXIMO_API_KEY>",
"MAXIMO_HOST": "<MAXIMO_HOST>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"ibm-maximo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"maximo-mcp-server"
],
"env": {
"MAXIMO_URL": "<MAXIMO_URL>",
"MAXIMO_API_KEY": "<MAXIMO_API_KEY>",
"MAXIMO_HOST": "<MAXIMO_HOST>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MAXIMO_URL=<MAXIMO_URL> -e MAXIMO_API_KEY=<MAXIMO_API_KEY> -e MAXIMO_HOST=<MAXIMO_HOST> ibm-maximo npx -y maximo-mcp-serverReplace <…> with your own values
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 IBM Maximo
How do I install IBM Maximo in Claude Code?
Run claude mcp add maximo-mcp-server -e MAXIMO_URL=<MAXIMO_URL> -e MAXIMO_API_KEY=<MAXIMO_API_KEY> -- npx -y maximo-mcp-server. Swap in your own Maximo address and API key.
What does IBM Maximo do?
It gives the assistant access to your Maximo instance: object structure discovery, schema inspection, OSLC queries, record creation and updates, and business workflow actions.
What do I need before running the server?
Node.js v18 or higher and a Maximo API key with read access. Downloading the OpenAPI schema first speeds up answers through offline lookups.
