• NEW TASK
  • ASSIGNED
  • PENDING
  • SYNCED

How to create maintenance work orders with your AI

Connect MaintainX once. After that, you just describe what's broken and your agent handles the paperwork.

Ask AI about this page

Short answer

How can I make work orders using AI?

Tell your agent what needs fixing and who should do it. It uses the MaintainX tools to build the task and assign it to a team member. You'll see the specific outcomes below.

The results.

Where your tasks land.

Your agent routes your requests into these specific outcomes.

NEW TASK

Work orders created

The agent uses create_new_work_order to turn your text into a formal record. This puts the task directly into your MaintainX queue.

ASSIGNED

Team members found

The agent uses list_team_members to identify the right person for the job. You get a task that's ready for the technician.

PENDING

Human review needed

The agent shows you the drafted details before finalizing. You decide if the description and assignee are correct.

SYNCED

MaintainX updated

Once you approve, the data is pushed to your account. Your logs stay current without you typing in the app.

The workflow

What your AI does when a fault is reported.

The agent acts as the bridge between your chat and your maintenance logs.

  1. Identify the issue

    Your agent reads your message to pull out the equipment name and the specific fault.

    create_new_work_order

  2. Find the right person

    The agent looks up your staff to find a qualified technician for the repair.

    list_team_members

  3. Build the order

    The agent uses the available tools to structure the work order with your provided details.

    create_new_work_order

  4. Finalize the task

    The agent presents the completed draft to you for a final check before it hits the system.

    create_new_work_order

Try it

Copy these to start.

Use these prompts to trigger the MaintainX tools.

Starting points

These are opening lines. Swap out the equipment and names for your actual facility data.

MaintainX Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_IQWu4LrBgISQyO5B2FFG3HEqbmYBrQUHbpRYVkgs/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — MaintainX capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "maintainx-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_IQWu4LrBgISQyO5B2FFG3HEqbmYBrQUHbpRYVkgs/mcp"
    }
  }
}
Copy into chat04

  • Create a new work order for the HVAC unit in the main lobby; it's making a loud grinding noise.

  • Find the team members in MaintainX and create a task for Sarah to check the conveyor belt tension.

  • There is a leak in the hydraulic press. Create a work order and assign it to the lead mechanic.

  • List my team members so I can decide who should handle the broken forklift.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect MaintainX once, then ask.

Click the link to connect your account. Your credentials stay encrypted on our side. Once connected, you can use these commands in any MCP-compatible client.

Connect MaintainX to your AI

FAQ

How this task behaves.

  • 01

    Can the AI delete work orders?

    No. The AI can only create new orders and list team members. It cannot delete or modify existing records.

  • 02

    Can the AI assign tasks automatically?

    The AI can suggest an assignee by looking up your team, but you must review the assignment before the order is finalized.

  • 03

    Does the AI work with Cursor or VS Code?

    Yes. It works with any MCP-compatible client, including Cursor and VS Code.

  • 04

    Can the AI upload photos of the broken equipment?

    No. The current tools only support text-based work orders and listing team members.

  • 05

    Can the AI change my MaintainX user permissions?

    No. The AI is limited to the specific tools provided in the manifest.

  • More questions about MaintainX? See everything the MaintainX Connector can do

Connect MaintainX to Claude, Cursor, ChatGPT & more