SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Maintainx MCP with Codex

Connect Codex to Maintainx MCP. Create a new urgent work order for hvac, list all open work orders at warehouse, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Maintainx logoMaintainx
Api Key

Maintainx is a cloud-based CMMS for centralizing maintenance data, communication, and workflows. It helps organizations streamline maintenance operations and improve team coordination.

36 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Maintainx MCP integration, Codex can create and update work orders, submit work requests, manage assets and locations, list parts, and add work order comments, all without leaving the terminal or the app, whichever you prefer.

Also integrate Maintainx with

Claude CodeClaude CoworkOpenAI Agents SDKClaude Agent SDKGrok BotOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1500+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Maintainx MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Maintainx task. The first time, Composio asks you to connect your Maintainx account.

For example, ask it to:

  • "Create a new urgent work order for HVAC"
  • "List all open work orders at warehouse"
  • "Add comment to work order 12345"

What is the Maintainx MCP server, and what's possible with it?

The Maintainx MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Maintainx account. It provides structured and secure access to your maintenance operations, so your agent can create work orders, update existing tasks, manage assets, and keep your teams aligned—automatically and on your behalf.

  • Work order creation and management: Instantly have your agent create new work orders, add detailed descriptions, set priorities, and assign them to the right teams or users.
  • Automated work order updates and comments: Let your agent update existing work orders or add comments for documentation and real-time communication between team members.
  • Asset and location tracking: Effortlessly list and retrieve all assets and locations across your organization, helping you keep maintenance data organized and accessible.
  • Category and team organization: Enable your agent to fetch and manage categories or teams, ensuring work orders and assets are classified and assigned correctly.
  • Smart work request portals: Have your agent generate custom work request portals so stakeholders can submit maintenance requests easily and securely.

Conclusion

You've successfully integrated Maintainx with Codex using Composio's MCP server. Now you can interact with Maintainx directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Maintainx operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1500+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Maintainx operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Maintainx action and event your agent gets out of the box.

Create Category

Tool to create a new category in MaintainX for organizing work orders, assets, and other items.

Create Location

Tool to create a new location in MaintainX.

Create Procedure Template

Create a MaintainX procedure template for work orders, with fields such as text, checkboxes, signatures, and multiple choice options.

Create Work Order

Creates a new work order in MaintainX with a required title and optional description, priority, dates, user and team assignees, procedure template, location, asset, and categories.

Create Work Order Comment

This tool creates a new comment on an existing work order in MaintainX.

Create Work Request

Tool to create a new work request in MaintainX.

Create Work Request Portal

Creates a new work request portal in MaintainX.

Delete Assets

Tool to delete an asset from MaintainX by its ID.

Delete Category

Tool to delete a category in MaintainX.

Find Entity

Search MaintainX work orders by title, locations and assets by name, and users by email, or list teams.

Get Asset

Retrieve detailed information about a MaintainX asset by its ID.

Get Category

Tool to retrieve detailed information about a specific category by its ID.

Get Location

Tool to retrieve detailed information about a specific location by its ID.

Get Purchase Order

Retrieve one MaintainX purchase order by ID.

Get User

Tool to retrieve detailed information about a specific user by their ID.

Get Vendor

Tool to retrieve detailed information about a specific vendor by its ID.

Get Work Order

Retrieve one MaintainX work order by ID with optional related-record expansions.

Get Work Order Costs

Tool to retrieve costs information for a specific work order by its ID.

List Asset Criticalities

Tool to retrieve a list of asset criticalities from MaintainX.

List Assets

This tool allows users to retrieve a list of all assets in their organization.

List Categories

List categories in the MaintainX organization with pagination.

List Locations

This tool retrieves a list of all available locations in the organization's MaintainX account.

List Meters

Tool to list all meters in your organization.

List Parts

Tool to list parts/inventory items with pagination and filtering.

List Procedure Templates

Tool to list procedure templates from MaintainX.

List Teams

This tool retrieves a list of all teams in your MaintainX organization.

List Work Order Comments

List one cursor-paginated page of comments attached to a work order.

List Work Orders

Action to list work orders from MaintainX.

List Work Request Portals

Lists work request portals in your MaintainX organization for managing external work requests.

List Work Requests

Tool to retrieve a list of work requests from MaintainX.

Update Asset

Update selected fields on an existing MaintainX maintenance asset.

Update Location

Update selected fields on an existing MaintainX maintenance location.

Update Vendor Attachment

Tool to update a vendor attachment in MaintainX.

Update Work Order

This tool allows users to update an existing work order in MaintainX by modifying specific attributes without affecting other unchanged fields.

Update Work Order Status

This tool allows users to update the status of a specific work order in MaintainX.

Update Work Request Portal

Updates an existing work request portal in MaintainX.

FRAMEWORKS

How to build Maintainx MCP Agent with another framework

Claude Code logo

Claude Code

Use Maintainx MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Maintainx MCP with Claude Cowork

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Maintainx MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Maintainx MCP with Claude Agent SDK

Grok Bot logo

Grok Bot

Use Maintainx MCP with Grok Bot

OpenClaw logo

OpenClaw

Use Maintainx MCP with OpenClaw

Hermes logo

Hermes

Use Maintainx MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Maintainx MCP with Atomic Agent

Google ADK logo

Google ADK

Use Maintainx MCP with Google ADK

LangChain logo

LangChain

Use Maintainx MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Maintainx MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Maintainx MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Maintainx MCP with LlamaIndex

CrewAI logo

CrewAI

Use Maintainx MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Maintainx MCP with Pydantic AI

AutoGen logo

AutoGen

Use Maintainx MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Maintainx MCP server, the agents and LLMs can only access a fixed set of Maintainx tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Maintainx and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Maintainx tools.

Yes, absolutely. You can configure which Maintainx scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Maintainx data and credentials are handled as safely as possible.

Start with Maintainx.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Maintainx tool your agent needs.Free to start.

Start building