How to integrate Maintainx MCP with Atomic Agent

Connect Atomic Agent 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.

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

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Maintainx.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Maintainx account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Maintainx with

How Atomic Agent connects to Maintainx

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Maintainx to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Maintainx. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Maintainx account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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.

Use Maintainx from Atomic Agent

With your account connected, ask Atomic Agent to work with Maintainx in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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.

FAQ

Frequently asked questions

Start with Maintainx.It takes 30 seconds.

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

Start building