Skip to main content
Glama
@veeemlab/itglue-mcp

@veeemlab/itglue-mcp

by veeemlab

@veeemlab/itglue-mcp

CI npm version npm downloads License: MIT

A Model Context Protocol (MCP) server for IT Glue with full read + write support. Talks JSON:API to api.itglue.com / api.eu.itglue.com / api.au.itglue.com and exposes 56 tools to any MCP-compatible client (Claude Desktop, Claude Code, MCPHub, etc.). Built-in rate limiting and retry-with-backoff keep you safely under IT Glue's 3000 req / 5min ceiling. Destructive operations require explicit confirm tokens; password reveal requires a separate acknowledgement; the HTTP transport requires a bearer token and binds to loopback by default.

Quick start

Add it to any MCP client's config (example for MCPHub's mcp_settings.json):

{
  "itglue": {
    "command": "npx",
    "args": ["-y", "@veeemlab/itglue-mcp"],
    "env": {
      "ITGLUE_API_KEY": "${ITGLUE_API_KEY}",
      "ITGLUE_REGION": "${ITGLUE_REGION}"
    }
  }
}

npx resolves the latest published version from npm and caches it; subsequent runs are instant.

Alternative: run from GitHub HEAD

If you want the bleeding-edge main branch without waiting for an npm release:

"args": ["-y", "github:veeemlab/itglue-mcp"]

Related MCP server: hudu-mcp

Environment

Variable

Required

Default

Notes

ITGLUE_API_KEY

yes

–

Sent as the x-api-key header.

ITGLUE_REGION

no

us

One of us, eu, au.

ITGLUE_READ_ONLY

no

false

Set to true to skip registration of all 25 mutating tools (create/update/delete/bulk/publish).

ITGLUE_TRANSPORT

no

stdio

Set to http to expose the server over Streamable HTTP on :PORT/mcp (with /health for liveness).

ITGLUE_HTTP_TOKEN

when http

–

Bearer token required on /mcp requests. Must be ≥ 16 chars; server refuses to start without it.

ITGLUE_HTTP_HOST

no

127.0.0.1

Only used when ITGLUE_TRANSPORT=http. Loopback by default — set explicitly (0.0.0.0 etc.) to expose.

PORT

no

3000

Only used when ITGLUE_TRANSPORT=http.

Tools

All tools share the itglue_ prefix. Read-only tools accept pageSize / pageNumber for page[size] / page[number], plus typed filters that map to filter[...].

Organizations — search_organizations, get_organization

Configurations — search_configurations, get_configuration, create_configuration, update_configuration, delete_configuration, list_configuration_types, list_configuration_statuses

Passwords — search_passwords, get_password, create_password, update_password, delete_password, list_password_categories (pass showPassword: true to reveal plaintext)

Documents — search_documents, get_document, create_document, list_document_sections, create_document_section, update_document_section, delete_document_section, publish_document

Flexible Assets — list_flexible_asset_types, list_flexible_asset_fields, search_flexible_assets, get_flexible_asset, create_flexible_asset, update_flexible_asset, delete_flexible_asset

Flexible assets use a dynamic traits object — always call list_flexible_asset_fields for the target type first to learn the valid keys.

Contacts — search_contacts, get_contact, create_contact, update_contact, delete_contact

Locations — list_locations, get_location, create_location, update_location, delete_location

Users — list_users, get_user

Groups — list_groups, get_group

Attachments — list_attachments, delete_attachment

Related Items — list_related_items, create_related_item, delete_related_item

Bulk — bulk_update, bulk_delete (one tool per operation across resource types)

Deduplication — find_org_match, find_contact_match, find_config_match, scan_duplicates

Health — itglue_health_check

Token-saving formatOptions

Every read tool accepts an optional formatOptions argument: format: "compact" keeps id + a small set of identifying attributes, fields: [...] whitelists specific attribute keys, omitEmpty: true drops null and empty values. Combine to reduce response tokens by up to 80%.

How it works

  • JSON:API request/response envelopes (type + id + attributes) with kebab-case attribute keys

  • GET / POST / PATCH / DELETE map cleanly to IT Glue's CRUD verbs

  • Errors from the API are parsed and surfaced as isError: true tool responses with the original errors[] payload

  • Transport defaults to StdioServerTransport; opt into StreamableHTTPServerTransport with ITGLUE_TRANSPORT=http

Rate limiting & retry

Every outbound request goes through a serialized queue with a configurable minimum interval (100 ms by default → ~10 req/s, comfortably under IT Glue's 3000 / 5 min limit). 429 responses are retried up to 3 times with exponential backoff (1 s, 2 s, 4 s) and honor the Retry-After header. 408 and 5xx responses are retried only for GET and DELETE — POST and PATCH surface the error to the caller, since retrying them risks duplicate side effects.

LRU response cache

GET responses are kept in an in-memory LRU cache with per-resource TTLs (1 hour for reference data, 5 minutes for organizations/locations, 1 minute for configurations/contacts/documents/flexible-assets, never for passwords). Successful write operations invalidate every cache entry for the touched resource.

Security

This server can read, modify, and delete IT Glue records — including passwords. Guards built in:

  • ITGLUE_READ_ONLY=true disables registration of all 25 mutating tools; listTools never advertises them. The intended posture for handing an LLM an inspection-only view.

  • Confirm tokens are required on every destructive tool. Each tool refuses to run unless the caller passes a verbatim confirm value matching the operation: DELETE_CONFIGURATION, DELETE_CONTACT, DELETE_DOCUMENT_SECTION, DELETE_FLEXIBLE_ASSET, DELETE_LOCATION, DELETE_ATTACHMENT, DELETE_RELATED_ITEM, DELETE_PASSWORD, PUBLISH_DOCUMENT, BULK_UPDATE, BULK_DELETE.

  • showPassword=true on get_password / search_passwords is conditionally gated: passing it without confirm: "SHOW_PASSWORD" is refused. The plaintext path stays available but cannot be hit by accident.

  • Error response redaction: API error bodies pass through a redactor that masks values whose key matches /password|secret|token|api_key|otp|private_key/i. IT Glue sometimes echoes back submitted fields on validation failure — the redactor catches that before the LLM sees them.

  • HTTP transport: requires ITGLUE_HTTP_TOKEN (≥ 16 chars) and binds to 127.0.0.1 by default. /mcp requests must carry Authorization: Bearer <token>; token comparison uses timingSafeEqual. /health is unauthenticated for liveness probes.

Passwords are never cached regardless of TTL settings.

Why dist/ is committed

npx -y github:veeemlab/itglue-mcp runs the package straight from GitHub without a build step. So the compiled output under dist/ is intentionally tracked in git. A prepare script (tsc) regenerates it as a fallback if the package is ever installed from source.

Local development

npm install
npm run build        # or npm run dev for watch mode
ITGLUE_API_KEY=... ITGLUE_REGION=eu node dist/index.js

Project layout:

src/
  index.ts            # stdio entry (+ optional HTTP with bearer auth)
  server.ts           # MCP server wiring + read-only filter
  client.ts           # IT Glue HTTP client (throttle, retry, cache)
  cache.ts            # LRU cache + per-resource TTL table
  format.ts           # formatOptions transform
  redact.ts           # secret-key redaction for error responses
  searchFallback.ts   # diacritic / first-word variants for filter[name]
  similarity.ts       # Jaro-Winkler + normalize for dedup tools
  tools/
    organizations.ts
    configurations.ts
    passwords.ts
    documents.ts
    flexibleAssets.ts
    contacts.ts
    locations.ts
    users.ts
    groups.ts
    attachments.ts
    relatedItems.ts
    bulk.ts
    deduplication.ts
    health.ts
    shared.ts         # tool helpers (schemas, errors, pagination, confirm)
    index.ts          # tool registry

License

MIT — see LICENSE.

Available Tools

56 tools
itglue_bulk_deleteA

Delete multiple resources of the same type in one call. Up to 50 ids per call. Returns separate succeeded[] and failed[] arrays so partial failures don't abort the batch. Destructive — requires confirm: "BULK_DELETE".

Inputs: resourceType (required), ids (required), confirm (required).

itglue_bulk_updateA

Update multiple resources of the same type in one call. JSON:API merge semantics — omitted attributes are left untouched. Up to 50 items per call. Returns separate succeeded[] and failed[] arrays so partial failures don't abort the batch. Destructive — requires confirm: "BULK_UPDATE".

Inputs: resourceType (required), items (required), confirm (required).

itglue_create_configurationC

Create a configuration. organizationId, name and configurationTypeId are required. Dates must be ISO8601.

Inputs: organizationId (required), name (required), configurationTypeId (required), configurationStatusId, +18 more.

itglue_create_contactC

Create a contact. organizationId and firstName are required. Emails/phones are arrays of {value, label-name, primary}.

Inputs: organizationId (required), firstName (required), lastName, title, +6 more.

itglue_create_documentC

Create a document. organizationId and name are required.

Inputs: organizationId (required), name (required), content, documentFolderId, +2 more.

itglue_create_document_sectionC

Create a section within a document. name and content are required.

Inputs: documentId (required), name (required), content (required), position.

itglue_create_flexible_assetA

Create a flexible asset. Call itglue_list_flexible_asset_fields first to learn the traits keys required by the chosen flexible asset type.

Inputs: organizationId (required), flexibleAssetTypeId (required), traits (required).

itglue_create_locationC

Create a location under an organization. organizationId and name are required.

Inputs: organizationId (required), name (required), addressOne, addressTwo, +10 more.

itglue_create_passwordA

Create a password entry. organizationId, name and password are required; username/url/notes are common optional fields. Sensitive write — requires confirm: "CREATE_PASSWORD".

Inputs: organizationId (required), name (required), password (required), confirm (required), +10 more.

itglue_delete_attachmentA

Delete an attachment from a parent resource. Destructive — requires confirm: "DELETE_ATTACHMENT".

Inputs: parentType (required), parentId (required), id (required), confirm (required).

itglue_delete_configurationB

Delete a configuration by id. Destructive — requires confirm: "DELETE_CONFIGURATION".

Inputs: id (required), confirm (required).

itglue_delete_contactA

Delete a contact by id. Destructive — requires confirm: "DELETE_CONTACT".

Inputs: id (required), confirm (required).

itglue_delete_document_sectionA

Delete a document section. Destructive — requires confirm: "DELETE_DOCUMENT_SECTION".

Inputs: documentId (required), id (required), confirm (required).

itglue_delete_flexible_assetA

Delete a flexible asset by id. Destructive — requires confirm: "DELETE_FLEXIBLE_ASSET".

Inputs: id (required), confirm (required).

itglue_delete_locationA

Delete a location by id. Destructive — requires confirm: "DELETE_LOCATION".

Inputs: id (required), confirm (required).

itglue_delete_passwordA

Delete a password entry by id. Destructive — requires confirm: "DELETE_PASSWORD".

Inputs: id (required), confirm (required).

itglue_find_config_matchA

Fuzzy-match a configuration name against existing IT Glue configurations. Exact match on serialNumber or assetTag forces Update confidence — those are strong identity signals. Use before creating a new configuration.

Inputs: name (required), organizationId, serialNumber, assetTag, +2 more.

itglue_find_contact_matchA

Fuzzy-match a contact (firstName + lastName) against existing IT Glue contacts. If primaryEmail is provided and matches an existing contact's primary email exactly, the score is forced to Update — email is a strong identity signal. Use before creating a new contact.

Inputs: firstName (required), lastName, organizationId, primaryEmail, +2 more.

itglue_find_org_matchA

Fuzzy-match an organization name against existing IT Glue organizations BEFORE creating a new one. Returns candidates ranked by similarity with a confidence label: Update (>=95%, almost certainly the same record), ManualReview (80-94%), CreateNew (<80%).

Inputs: name (required), organizationTypeId, threshold, pageSize.

itglue_get_configurationA

Fetch a single configuration by id.

Inputs: id (required), formatOptions.

itglue_get_contactC

Fetch one contact by id.

Inputs: id (required), formatOptions.

itglue_get_documentC

Fetch one document by id.

Inputs: id (required), formatOptions.

itglue_get_flexible_assetB

Fetch a single flexible asset by id.

Inputs: id (required), formatOptions.

itglue_get_groupB

Fetch a single IT Glue group by id.

Inputs: id (required), formatOptions.

itglue_get_locationB

Fetch one location by id.

Inputs: id (required), formatOptions.

itglue_get_organizationB

Fetch a single organization by id.

Inputs: id (required), formatOptions.

itglue_get_passwordA

Fetch one password. Pass showPassword=true to include the plaintext password value (requires confirm).

Inputs: id (required), showPassword, confirm.

itglue_get_userA

Fetch a single IT Glue user by id.

Inputs: id (required), formatOptions.

itglue_health_checkA

Ping IT Glue by requesting a single organization. Returns status, region host and whether the API key is accepted.

Inputs: no named parameters.

itglue_list_attachmentsA

List attachments on a parent resource. Returns metadata only — file names, sizes, content types, and download URLs (use the URL out-of-band to fetch the actual file).

Inputs: parentType (required), parentId (required), pageSize, pageNumber, +1 more.

itglue_list_configuration_statusesA

List configuration status definitions — IT Glue's lifecycle states like 'Active', 'Inactive', 'In Service', 'Decommissioned', 'In Stock', 'Stolen', 'Lost'. Returns status ids used as configurationStatusId when filtering search_configurations or setting status on create/update. Synonyms: list config statuses, list asset statuses, list lifecycle states.

Inputs: name, pageSize, pageNumber, formatOptions.

itglue_list_configuration_typesA

List configuration type definitions — IT Glue's catalog of hardware/asset kinds like 'Laptop', 'Server', 'Workstation', 'Firewall', 'Switch', 'Printer', 'Mobile Device', 'Virtual Machine'. Returns type ids used as configurationTypeId when filtering search_configurations or creating new configurations. Synonyms: list config types, list device types, list asset types, list hardware categories.

Inputs: name, pageSize, pageNumber, formatOptions.

itglue_list_document_sectionsC

List sections of a document.

Inputs: documentId (required), pageSize, pageNumber, formatOptions.

itglue_list_flexible_asset_fieldsA

List the schema (custom field definitions) for a specific flexible asset type. Returns the trait keys, their kinds (Text, Number, Date, Select, etc.), and which are required. Call AFTER itglue_list_flexible_asset_types and BEFORE itglue_create_flexible_asset / itglue_update_flexible_asset so you know what traits to populate. Synonyms: list FA fields, list flexible asset schema, show flexible asset type fields, get trait definitions, describe flexible asset type.

Inputs: flexibleAssetTypeId (required), pageSize, pageNumber, formatOptions.

itglue_list_flexible_asset_typesA

List flexible asset type definitions (schemas) — the catalog of custom IT documentation asset categories like 'Active Directory', 'Backup', 'SSL Certificate', 'Email Provider', 'LAN Network', 'Licensing'. Call this FIRST to learn what flexible asset categories exist in this IT Glue tenant before searching or creating flexible assets. Returns type ids used as flexibleAssetTypeId in other tools. Synonyms: list FA types, list flexible asset schemas, list flexible asset categories, list custom asset types, list IT Glue asset definitions.

Inputs: name, enabled, pageSize, pageNumber, +1 more.

itglue_list_groupsC

List IT Glue user groups (RBAC). Supports filter[name].

Inputs: name, pageSize, pageNumber, formatOptions.

itglue_list_locationsA

List locations. If organizationId is provided the tool scopes to /organizations/{id}/relationships/locations; otherwise it returns all accessible locations.

Inputs: organizationId, name, city, country, +3 more.

itglue_list_password_categoriesA

List password category definitions — IT Glue's groupings for credential records like 'Local Admin', 'Domain Admin', 'Service Account', 'Vendor', 'Application', 'Email', 'Wi-Fi', 'VPN'. Returns category ids used as passwordCategoryId when filtering search_passwords or creating new password entries. Synonyms: list credential categories, list password types, list account categories.

Inputs: name, pageSize, pageNumber.

itglue_list_usersA

List IT Glue users (people with login access — distinct from contacts). May require admin permissions on the API key. Supports filter[name], filter[email], filter[role_name].

Inputs: name, email, roleName, pageSize, +2 more.

itglue_publish_documentA

Publish a document (makes the latest draft visible). Destructive — requires confirm: "PUBLISH_DOCUMENT".

Inputs: id (required), confirm (required).

itglue_scan_duplicatesA

Scan an entire IT Glue resource type for groups of likely duplicate records by pairwise name similarity. Useful for cleanup audits. Capped at 5000 records per scan to bound cost; use organizationId to narrow. Returns groups of 2+ records that are above the threshold (default 0.85).

Inputs: resourceType (required), organizationId, threshold, pageSize, +1 more.

itglue_search_configurationsA

Search IT Glue configurations. IT Glue's filter[name] is a case-sensitive substring match — not fuzzy. On a 0-hit response, the tool auto-retries with first-word and diacritic-stripped variants and reports which strategy worked via meta.search_strategy. For fuzzy lookup with confidence scoring (and serial/asset-tag exact-match boosting), use itglue_find_config_match.

Inputs: name, organizationId, configurationTypeId, configurationStatusId, +7 more.

itglue_search_contactsA

Search IT Glue contacts. IT Glue's filter[first_name] is a case-sensitive substring match — not fuzzy. On a 0-hit response, the tool auto-retries with diacritic-stripped variants and reports which strategy worked via meta.search_strategy. For fuzzy lookup with email exact-match boosting, use itglue_find_contact_match.

Inputs: firstName, lastName, organizationId, contactTypeId, +5 more.

itglue_search_documentsA

Search IT Glue documents. IT Glue's filter[name] is a case-sensitive substring match — not fuzzy. On a 0-hit response, the tool auto-retries with first-word and diacritic-stripped variants and reports which strategy worked via meta.search_strategy.

Inputs: name, organizationId, documentFolderId, pageSize, +2 more.

itglue_search_flexible_assetsB

Search flexible assets. You must supply filterFlexibleAssetTypeId — IT Glue requires it.

Inputs: flexibleAssetTypeId (required), name, organizationId, pageSize, +2 more.

itglue_search_organizationsA

Search IT Glue organizations. IT Glue's filter[name] is a case-sensitive substring match — not fuzzy. On a 0-hit response, the tool auto-retries with first-word and diacritic-stripped variants and reports which strategy worked via meta.search_strategy. For genuine fuzzy lookup with confidence scoring, use itglue_find_org_match.

Inputs: name, organizationTypeId, organizationStatusId, psaIntegrationType, +3 more.

itglue_search_passwordsC

Search passwords. By default IT Glue returns metadata only; pass showPassword=true to include the password value in the response.

Inputs: name, organizationId, passwordCategoryId, url, +5 more.

itglue_update_configurationA

Update a configuration. Provide the id plus any attributes to change. Attributes not provided are left untouched.

Inputs: id (required), name, hostname, primaryIp, +19 more.

itglue_update_contactC

Update a contact by id.

Inputs: id (required), firstName, lastName, title, +6 more.

itglue_update_document_sectionC

Update a document section by id.

Inputs: documentId (required), id (required), name, content, +1 more.

itglue_update_flexible_assetA

Update a flexible asset. Provide the id plus the traits you want to change; other trait keys remain untouched.

Inputs: id (required), traits (required).

itglue_update_locationC

Update a location by id.

Inputs: id (required), name, addressOne, addressTwo, +10 more.

itglue_update_passwordA

Update a password entry by id. Sensitive write — requires confirm: "UPDATE_PASSWORD".

Inputs: id (required), confirm (required), name, username, +10 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 56 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes (CRUD per resource), but the pairing of search_ and find_ tools for configurations, contacts, and organizations introduces some ambiguity. Descriptions help differentiate, but an agent might struggle to choose between them without careful reading.

    Naming Consistency4/5

    Tool names follow a consistent itglue_<action>_<resource> pattern in snake_case. Minor inconsistency: some resources are plural (configurations) while others are singular in tools like itglue_get_configuration, but the pattern is predictable overall.

    Tool Count4/5

    56 tools is high but justified by the breadth of resources (organizations, contacts, configurations, etc.) and operations (CRUD, bulk, fuzzy match, search). Could be streamlined by merging some search tools, but each tool has a clear role.

    Completeness3/5

    The tool set covers most CRUD operations for major resources, but notably missing create/delete for organizations, which is a significant gap for lifecycle management. Also lacks create for groups/users, but those may be read-only. Overall, noticeable gaps for a complete workflow.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      Not graded
      maintenance
      An MCP server that enables LLMs to interact with IT Glue documentation, including organizations, configurations, passwords, and flexible assets. It provides tools for listing, creating, and updating managed service provider (MSP) data through the IT Glue API.
      31
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server for the Hudu IT documentation platform that provides 39 tools and 6 resources for managing companies, assets, articles, and passwords. It enables users to interact with their documentation and assets through any MCP-compatible client using stdio or HTTP transport.
      3
      Apache 2.0
    • A
      license
      C
      quality
      B
      maintenance
      An MCP server that connects AI assistants to the ThreatLocker Portal API with 44 tools for managing computers, approvals, action logs, tags, maintenance mode, and more across single-org and multi-tenant setups.
      44
      65 PyPI
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Read-only MCP server for IT Glue that enables natural-language search and retrieval of organizational data, credentials (as secure links), documents, configurations, and other tenant records without ever exposing secrets or writing to IT Glue.
      -