---
title: "Maintainx integration for LuumenAI"
url: "https://www.luumen.ai/integrations/maintainx/"
entity: SoftwareIntegration
category: "Project management"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Maintainx integration for LuumenAI

Read assets, locations, and parts in MaintainX, then raise work orders on approval.

## What LuumenAI can do with Maintainx

LuumenAI connects to Maintainx with an API token and exposes 30 tools (17 read-only · 11 write · 2 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 30 tools (17 read-only · 11 write · 2 destructive)
- Plan: available on all plans
- Category: Project management

## About Maintainx with LuumenAI

Connect MaintainX and your maintenance records become something you can ask questions about from the terminal. Look up an asset, check which location it sits in, read costs on a past work order, or check part stock. When it's time to act, Luumen drafts the work order, comment, or new location and shows it to you before anything is written. Authentication is by API key.

## Example tools

Read-only (17 in total):

- `MAINTAINX_FIND_ENTITY` — A tool to search and find specific entities within MaintainX by specified fields.
- `MAINTAINX_GET_CATEGORY` — Retrieve detailed information about a specific category by its ID.
- `MAINTAINX_GET_LOCATION` — Retrieve detailed information about a specific location by its ID.
- `MAINTAINX_GET_USER` — Retrieve detailed information about a specific user by their ID.
- `MAINTAINX_GET_VENDOR` — Retrieve detailed information about a specific vendor by its ID.
- `MAINTAINX_GET_WORKORDERS_COSTS` — Retrieve costs information for a specific work order by its ID.
- `MAINTAINX_LIST_ASSET_CRITICALITIES` — Retrieve a list of asset criticalities from MaintainX.
- `MAINTAINX_LIST_ASSETS` — This tool allows users to retrieve a list of all assets in their organization.

Write and destructive (13 in total, approval required by default):

- `MAINTAINX_CREATE_CATEGORY` — Create a new category in MaintainX for organizing work orders, assets, and other items.
- `MAINTAINX_CREATE_LOCATION` — Create a new location in MaintainX.
- `MAINTAINX_CREATE_PROCEDURE_TEMPLATE` — Create a new procedure template in MaintainX with checklist items for work orders.
- `MAINTAINX_CREATE_WORK_ORDER` — This tool creates a new work order in MaintainX.
- `MAINTAINX_CREATE_WORK_ORDER_COMMENT` — This tool creates a new comment on an existing work order in MaintainX.
- `MAINTAINX_CREATE_WORK_REQUEST` — Create a new work request in MaintainX.
- `MAINTAINX_CREATE_WORK_REQUEST_PORTAL` — Creates a new work request portal in MaintainX.
- `MAINTAINX_DELETE_ASSETS` — Delete an asset from MaintainX by its ID.

## Frequently asked questions

### How does LuumenAI connect to Maintainx?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Maintainx on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 2 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Maintainx — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/maintainx/