🎯 What is This?

The Maximo MCP Server is a Model Context Protocol server that connects AI assistants (like Antigravity, Cursor, or VS Code Copilot) directly to your IBM Maximo environment. Instead of manually copying API documentation, the AI can:

| Capability | Description | |------------|-------------| | 🔍 Discover APIs | Find available Object Structures (MXWO, MXASSET, etc.) | | 📋 Inspect Schemas | Get exact field names, types, and descriptions | | 📊 Query Live Data | Execute OSLC REST queries and see real results | | 🎨 Generate UI | Create Carbon Design System tables and dashboards | | ✅ Validate Instantly | Test queries before generating final code |

📚 Documentation

Core Guides

| Document | Description | |----------|-------------| | 📖 Maximo MCP Server Guide | Complete setup, configuration, and tool reference | | 🔌 Maximo API Interaction Guide | OSLC query syntax, code generation patterns, troubleshooting | | 🎬 Asset Manager Case Study | Step-by-step walkthrough of building a complete app |

French Translations

| Document | Description | |----------|-------------| | 📖 Guide du Serveur MCP Maximo | Version française du guide complet | | 🔌 Guide d'Interaction API Maximo | Version française du guide API |

Word Documents

All guides are also available in .docx format in the docs/ folder for offline reading and sharing.

⚡ Quick Start

Prerequisites

• Node.js v18 or higher
• Maximo API Key with read access
• AI IDE with MCP support (Antigravity, Cursor, VS Code + Continue)

Installation

Installation

Method 1: Run directly with npx (Recommended)

npx maximo-mcp-server

Method 2: Clone from Source

# Clone the repository
git clone https://github.com/markusvankempen/maximo-mcp-ai-integration-options.git
cd maximo-mcp-ai-integration-options

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your Maximo credentials

Environment Configuration

Edit the .env file with your Maximo credentials:

# .env (never commit this file!)
MAXIMO_URL=https://your-maximo-host.com/maximo/api
MAXIMO_HOST=https://your-maximo-host.com
MAXIMO_API_KEY=your-api-key-here
MAXIMO_OPENAPI_PATH=./maximo_openapi.json
PORT=3002

Download the OpenAPI Schema (Recommended)

The OpenAPI schema file enables offline schema lookups for faster AI responses:

# Download from your Maximo instance
curl -X GET "https://your-maximo-host.com/maximo/oslc/oas/api" \
     -H "apikey:your-api-key-here" \
     -o maximo_openapi.json

Alternatively, download via Swagger UI at: `https://your

... View full README on GitHub