X (Twitter)LinkedInGitHubDiscordYouTube

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.

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.

30 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.

Also integrate Maintainx with

Claude CodeOpenAI Agents SDKClaude Agent SDKCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

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

Tool to create a new procedure template in MaintainX with checklist items for work orders.

Create Work Order

This tool creates a new work order in MaintainX.

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

A tool to search and find specific entities within MaintainX by specified fields.

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 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 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

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

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 Orders

Action to list work orders from MaintainX.

List Work Request Portals

Tool to list all work request portals in your MaintainX organization.

List Work Requests

Tool to retrieve a list of work requests from MaintainX.

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

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

Codex logo

Codex

Use Maintainx MCP with Codex

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. Claude Cowork 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