IBM Maximo MCP for AI

Empower your AI assistant in VS Code with real-time access to your IBM Maximo data. This extension registers an MCP Server Definition Provider using the official VS Code API, allowing AI tools like GitHub Copilot, Continue, and Cursor to automatically discover and connect to the Maximo MCP server.

Key Features

MCP Server Definition Provider: Automatically registers with VS Code's MCP infrastructure — no manual config editing.
Automated Setup: Run the Maximo: Configure MCP Server command to enter your URL and API key.
Secure Configuration: Stores credentials in VS Code user settings.
Schema Discovery: Gives AI assistants deep knowledge of your Maximo Object Structures.
Live Data: Fetch real-time records directly from your Maximo instance using OSLC.
AI-First: Shows up when users search @mcp in Extensions or use the MCP server picker in Copilot Chat.

Getting Started

Install the extension from the VS Code Marketplace.
Open the Command Palette (Cmd+Shift+P or Ctrl+Shift+P).
Search for "Maximo: Configure MCP Server".
Enter your Maximo URL and API Key.
Your AI assistant will now have access to Maximo tools!

Example Questions to Ask Your AI

Once configured, try asking your AI assistant:

Work Orders: "Show me the last 5 work orders for site BEDFORD that are still open."
Assets: "Find all assets in the BOILER location and tell me their current status."
Schema: "What fields are available in the MXWO object structure?"
Details: "Get all information for work order #1001."
Troubleshooting: "Are there any overdue work orders assigned to me?"

Tools Provided

The extension enables the following MCP tools for your AI:

Tool	Description
`list_object_structures`	Browse available Maximo APIs
`get_schema_details`	Understand fields and relationships for a specific object
`query_maximo`	Execute powerful OSLC queries with filters and sorting
`get_instance_details`	Fetch full data for a specific record

Requirements

VS Code v1.101.0 or higher
A running IBM Maximo instance (7.6.1+ or MAS) with REST API enabled
A valid Maximo API Key

How It Works

This extension uses the vscode.lm.registerMcpServerDefinitionProvider API to programmatically register the Maximo MCP server with VS Code. When activated, the extension:

Reads your configured Maximo URL and API Key from VS Code settings
Provides VS Code with an McpStdioServerDefinition that runs npx -y maximo-mcp-server
Automatically notifies VS Code when your configuration changes
VS Code handles the MCP server lifecycle (start, stop, restart)

Troubleshooting

AI doesn't see the tools?

Ensure you have a compatible AI extension installed (e.g., GitHub Copilot with MCP support)
Check the Output panel in VS Code and select MCP from the dropdown to see connection logs
Run the Maximo: Configure MCP Server command again to verify your credentials

Server not appearing?

Make sure both maximoMcp.url and maximoMcp.apiKey are set — the server won't register without them
Check that npx is available in your PATH

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Developed by: Markus van Kempen
Project Home: Maximo-MCP AI Integration Options