Maintainx MCP server

Connect Maintainx to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy MaintainxBook a demo

What you can do with the Maintainx MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list vendors tool in Maintainx
  • Use the list purchase orders tool in Maintainx
  • Use the list work orders tool in Maintainx
  • Use the create asset tool in Maintainx
  • Use the list meters tool in Maintainx
  • Use the create vendor tool in Maintainx

Supported Tools

list_vendors

List Vendors

Lists vendors in MaintainX. Vendors supply parts and services, and can be linked to purchase orders, assets, and locations. For multi-organization keys, call list_organizations and pass organizationId.

list_purchase_orders

List Purchase Orders

Lists purchase orders from MaintainX. Purchase orders track item procurement from vendors, including quantities and pricing. For multi-organization keys, call list_organizations and pass organizationId.

list_work_orders

List Work Orders

Lists work orders from MaintainX with optional filtering by status, priority, and date ranges. Supports cursor-based pagination. Returns a summary of each work order. For multi-organization keys, call list_organizations and pass organizationId.

create_asset

Create Asset

Creates a new asset in MaintainX. Assets represent equipment, machines, or other trackable items. Supports setting metadata like serial number, manufacturer, model, location, and parent asset for hierarchical relationships. For multi-organization keys, call list_organizations and pass organizationId.

list_meters

List Meters

Lists meters from MaintainX, optionally filtered by asset. Meters track equipment performance metrics like runtime hours, mileage, and pressure for condition-based maintenance. For multi-organization keys, call list_organizations and pass organizationId.

create_vendor

Create Vendor

Creates a new vendor in MaintainX. Vendors supply parts and services and can be linked to purchase orders and assets. For multi-organization keys, call list_organizations and pass organizationId.

update_asset

Update Asset

Updates an existing asset in MaintainX. Can modify name, description, metadata, location, and associations. Only provided fields will be updated. For multi-organization keys, call list_organizations and pass organizationId.

create_part

Create Part

Creates a new part in MaintainX inventory. Parts can be tracked for stock levels, associated with work orders, and linked to vendors and purchase orders. For multi-organization keys, call list_organizations and pass organizationId.

list_assets

List Assets

Lists assets from MaintainX with optional filtering by location. Supports cursor-based pagination. Returns a summary of each asset. For multi-organization keys, call list_organizations and pass organizationId.

update_work_order

Update Work Order

Updates an existing work order in MaintainX. Can modify title, description, priority, status, assignees, asset, location, categories, and due date. Only provided fields will be updated. For multi-organization keys, call list_organizations and pass organizationId.

get_asset

Get Asset

Retrieves detailed information about a specific asset by ID, including its name, description, serial number, manufacturer, model, location, status, and custom fields. For multi-organization keys, call list_organizations and pass organizationId.

create_work_order

Create Work Order

Creates a new work order in MaintainX. Work orders can be reactive (one-off repairs) or preventive maintenance. Supports setting priority, assignees, associated assets, locations, categories, and due dates. For multi-organization keys, call list_organizations and pass organizationId.

list_locations

List Locations

Lists all locations configured in MaintainX. Locations can be associated with assets, work orders, vendors, and teams. For multi-organization keys, call list_organizations and pass organizationId.

list_users

List Users

Lists users in the MaintainX organization. Can filter to only return assignable users (those who can be assigned to work orders). For multi-organization keys, call list_organizations and pass organizationId.

get_work_order

Get Work Order

Retrieves detailed information about a specific work order by its ID, including title, description, status, priority, assignees, asset, location, and dates. For multi-organization keys, call list_organizations and pass organizationId.

list_categories

List Categories

Lists work order categories from MaintainX. Categories help classify work orders according to organizational needs. Use category names when creating or updating work orders. For multi-organization keys, call list_organizations and pass organizationId.

send_message

Send Message

Sends a message to a MaintainX conversation. Can be used to post updates, comments, or notifications to work order threads or other conversations. For multi-organization keys, call list_organizations and pass organizationId.

create_location

Create Location

Creates a new location in MaintainX. Locations can be assigned to assets, work orders, vendors, and teams. For multi-organization keys, call list_organizations and pass organizationId.

create_purchase_order

Create Purchase Order

Creates a new purchase order in MaintainX. Purchase orders specify types, quantities, and prices for items to buy, typically parts from a vendor. Items can reference existing parts inventory or be custom line items. For multi-organization keys, call list_organizations and pass organizationId.

create_work_request

Create Work Request

Creates a new work request in MaintainX. Work requests can be reviewed and approved before being converted into work orders. Useful for request-then-approve maintenance workflows. For multi-organization keys, call list_organizations and pass organizationId.

list_parts

List Parts

Lists parts from MaintainX inventory. Supports cursor-based pagination. Returns part name, description, stock levels, and costs. For multi-organization keys, call list_organizations and pass organizationId.

delete_asset

Delete Asset

Permanently deletes an asset from MaintainX. This action cannot be undone. For multi-organization keys, call list_organizations and pass organizationId.

create_meter_reading

Create Meter Reading

Records a new meter reading in MaintainX. Meter readings track equipment metrics like runtime hours, mileage, pressure, or temperature. Useful for condition-based and predictive maintenance. For multi-organization keys, call list_organizations and pass organizationId.

set_asset_status

Set Asset Status

Sets the operational status of an asset in MaintainX (Online, Offline, or Ignore). Can record planned or unplanned downtime with start/end times and descriptions. For multi-organization keys, call list_organizations and pass organizationId.

list_teams

List Teams

Lists teams in the MaintainX organization. Teams consist of users with similar roles or functions and can be assigned to work orders, locations, and assets. For multi-organization keys, call list_organizations and pass organizationId.

list_conversations

List Conversations

Lists MaintainX conversations and their IDs for send_message. For multi-organization keys, call list_organizations and pass organizationId.

list_organizations

List Organizations

Lists organizations accessible to the MaintainX API key. Use organizationId from this result with other tools when the key spans multiple organizations.

list_work_requests

List Work Requests

Lists MaintainX work requests with optional title, status, and priority filters. For multi-organization keys, call list_organizations and pass organizationId.

Connect Maintainx to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Maintainx in Metorial. In your Metorial portal, enable the Maintainx MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Maintainx tools.

Run Maintainx through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Maintainx and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Maintainx tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Maintainx

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Technical notes for Maintainx

Create, update, and track work orders and work requests. Manage assets, locations, and parts; record meter readings; create purchase orders and vendors. Discover organizations, users, teams, categories, and conversations, and send conversation messages.

Frequently asked questions

Common questions about connecting Maintainx to AI agents with Metorial.

  1. How many tools does the Maintainx MCP server have?
    The Maintainx MCP server exposes 28 tools, including List Vendors, List Purchase Orders, List Work Orders. Each one is governed and traced through Metorial.
  2. Maintainx exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Maintainx MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Maintainx and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Maintainx MCP server yourself or use the hosted gateway.

Connect Maintainx to production AI agents

See how Metorial gives your team governed access to Maintainx, with tracing and security controls built in.

Book a demoDeploy Maintainx