How to connect Maintainx to Claude

Connect Claude Web, Desktop and Cowork 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

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Maintainx account to Claude via Composio Connect, enabling it to create a new urgent work order for HVAC, list all open work orders at warehouse, add comment to work order 12345, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

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

Also integrate Maintainx with

Connecting Maintainx to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Maintainx account

Back in Claude, ask it to connect to Maintainx or give it any Maintainx-related task.

For example, ask Claude to:

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

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Maintainx account is ready to use.

What is the Maintainx Claude Connector, 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.

Troubleshooting

1. Why does Claude not use the Composio connector for Maintainx?

The connector can show as connected, but Claude must use it in each Maintainx conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Maintainx again.

2. Why does Claude show an MCP server error before Maintainx connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Maintainx.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Maintainx.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Maintainx authorization link not work?

The Composio connector is one server. Your Maintainx account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Maintainx connection.
  • Composio creates a fresh Maintainx authorization link.
  • Open that link in your browser and finish the Maintainx sign-in.

4. Why do Maintainx actions fail after they worked before?

The Maintainx connection can expire or lose permission.

  • Ask Claude to inspect the Maintainx connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Maintainx account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Maintainx.
  • If the action still fails with a permission error, check that the connected account has that permission in Maintainx itself.

5. How do I switch to a different Maintainx account?

Claude can manage the Maintainx connection for you.

  • Ask Claude to disconnect or delete the current Maintainx account.
  • Ask Claude to connect Maintainx again.
  • Open the new Composio authorization link for Maintainx.
  • Sign in with the other Maintainx account in the browser.
  • After the account connects, ask Claude to retry the Maintainx task.

6. Why is my Maintainx connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Maintainx connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Maintainx tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Maintainx.
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