@veeemlab/itglue-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@veeemlab/itglue-mcp search organizations with name Contoso"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@veeemlab/itglue-mcp
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 |
| yes | – | Sent as the |
| no |
| One of |
| no |
| Set to |
| no | stdio | Set to |
| when | – | Bearer token required on |
| no |
| Only used when |
| no |
| Only used when |
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
traitsobject — always calllist_flexible_asset_fieldsfor 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 keysGET/POST/PATCH/DELETEmap cleanly to IT Glue's CRUD verbsErrors from the API are parsed and surfaced as
isError: truetool responses with the originalerrors[]payloadTransport defaults to
StdioServerTransport; opt intoStreamableHTTPServerTransportwithITGLUE_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=truedisables registration of all 25 mutating tools;listToolsnever 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
confirmvalue 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=trueonget_password/search_passwordsis conditionally gated: passing it withoutconfirm: "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 to127.0.0.1by default./mcprequests must carryAuthorization: Bearer <token>; token comparison usestimingSafeEqual./healthis 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.jsProject 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 registryLicense
MIT — see LICENSE.
Available Tools
56 toolsitglue_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
Scored across 56 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for GLPI: tickets, ITIL, assets, knowledge base. GLPI 10/11. Not affiliated with Teclib'.
One OAuth connector for your team's remote MCP servers, with Tool Packs, guardrails and logs.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.
Related MCP Servers
- FlicenseAqualityNot gradedmaintenanceAn 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-
- AlicenseNot gradedqualityBmaintenanceAn 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.3Apache 2.0
- AlicenseCqualityBmaintenanceAn 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.4465 PyPI2MIT
- FlicenseNot gradedqualityDmaintenanceRead-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.-