MCP IT Glue Server
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., "@MCP IT Glue Server find the backup server configuration for Acme Corp"
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.
MCP IT Glue Server
A comprehensive Model Context Protocol (MCP) server for IT Glue API integration. This server enables AI assistants like Claude to interact with IT Glue's documentation and asset management system.
Features
Core Entities
Organizations: List, search, create, and update organizations
Configurations: Manage devices and assets with full CRUD operations
Passwords: Secure password management with controlled access
Contacts: Manage contact information for organizations
Extended Entities
Flexible Assets: Custom documentation schemas and instances
Checklists: Task lists with completion tracking
Documents: SOPs, runbooks, and uploaded files
Locations: Physical/logical sites within organizations
Domains: Active Directory and web domains
Relationships & Reference Data
Related Items: Create and manage relationships between resources
Reference Data: Manufacturers, models, OS, configuration types, etc.
Production-Ready Features
Rate Limiting: Automatic retry with exponential backoff
Error Taxonomy: Structured error types (Auth, NotFound, Validation, RateLimit, Server)
Pagination: Auto-pagination with iterator support for large datasets
Async/Await: Full async support throughout
Related MCP server: mcp-itglue
Installation
Using uv (Recommended)
# Clone the repository
git clone <repository-url>
cd mcp-itglue
# Create virtual environment and install dependencies
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e .Using pip
pip install -e .Configuration
Set the following environment variables:
Variable | Description | Default |
| Your IT Glue API key (required) | - |
| IT Glue API base URL |
|
| Request timeout in seconds |
|
| Maximum retry attempts |
|
Regional API URLs
US:
https://api.itglue.com(default)EU:
https://api.eu.itglue.comAustralia:
https://api.au.itglue.com
Getting an API Key
Log in to IT Glue
Go to Account Settings > API Keys
Generate a new API key
Store it securely - keys do not expire but can be revoked
Usage
Running the Server
# Using the installed script
mcp-itglue
# Or directly with Python
python -m mcp_itglue.serverClaude Desktop Integration
Add the following to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"itglue": {
"command": "uv",
"args": [
"--directory",
"/path/to/mcp-itglue",
"run",
"mcp-itglue"
],
"env": {
"ITGLUE_API_KEY": "your-api-key-here"
}
}
}
}Restart Claude Desktop after updating the configuration.
Available Tools (80+)
Organizations (5 tools)
Tool | Description |
| List organizations with optional filters |
| Get a specific organization by ID |
| Search organizations by name |
| Create a new organization |
| Update an existing organization |
Configurations (5 tools)
Tool | Description |
| List configurations with optional filters |
| Get a specific configuration by ID |
| Search configurations by name/hostname |
| Create a new configuration |
| Update an existing configuration |
Passwords (6 tools)
Tool | Description |
| List passwords (values hidden by default) |
| Get a password with optional value retrieval |
| Search passwords by name |
| Create a new password entry |
| Update an existing password |
| Delete a password entry |
Contacts (6 tools)
Tool | Description |
| List contacts with optional filters |
| Get a specific contact by ID |
| Search contacts by name |
| Create a new contact |
| Update an existing contact |
| Delete a contact |
Flexible Assets (10 tools)
Tool | Description |
| List all flexible asset type schemas |
| Get type with field definitions |
| List fields for a type |
| List flexible asset instances |
| Get a specific flexible asset |
| Search flexible assets by name |
| Create a new flexible asset |
| Update an existing flexible asset |
| Delete a flexible asset |
| Get all flexible assets for an org |
Checklists (10 tools)
Tool | Description |
| List checklists with optional filters |
| Get checklist with tasks |
| Get checklists for an organization |
| Create a new checklist |
| Update an existing checklist |
| Mark a checklist as completed |
| Mark a checklist as incomplete |
| Delete multiple checklists |
| List incomplete/overdue checklists |
Documents (7 tools)
Tool | Description |
| List documents with optional filters |
| Get document with content |
| Search documents by name |
| Update document metadata/content |
| Get documents for an organization |
| List document folders |
| Get a specific document folder |
Locations (7 tools)
Tool | Description |
| List locations with optional filters |
| Get a specific location |
| Search locations by name |
| Create a new location |
| Update an existing location |
| Delete a location |
| Get locations for an organization |
Domains (5 tools)
Tool | Description |
| List domains with optional filters |
| Get a specific domain |
| Search domains by name |
| Get domains for an organization |
| List domains expiring soon |
Related Items (7 tools)
Tool | Description |
| List items related to a resource |
| Create a relationship |
| Update relationship notes |
| Delete relationships |
| Get all relationships for a config |
| Get all relationships for a contact |
| Get relationships for a flexible asset |
Reference Data (15 tools)
Tool | Description |
| List device manufacturers |
| Search manufacturers by name |
| List device models |
| Search models by name |
| List operating systems |
| Search operating systems |
| List configuration types |
| List configuration statuses |
| List contact types |
| List organization types |
| List organization statuses |
| List password categories |
| List countries |
| List regions for a country |
| Get all reference data at once |
Error Handling
The client provides structured error types:
from mcp_itglue.client import (
ITGlueError, # Base error
ITGlueAuthError, # 401/403 - Authentication/authorization failed
ITGlueNotFoundError, # 404 - Resource not found
ITGlueValidationError, # 400/422 - Request validation failed
ITGlueConflictError, # 409 - Resource conflict
ITGlueRateLimitError, # 429 - Rate limit exceeded
ITGlueServerError, # 5xx - Server errors
)All errors include:
message: Human-readable error messagestatus_code: HTTP status codeerrors: List of structured error details from the API
Rate Limiting
IT Glue API allows a maximum of 3000 requests per 5-minute window. The client automatically:
Retries on rate limit errors (429) with exponential backoff
Respects
Retry-Afterheaders when providedRetries on transient server errors (500, 502, 503, 504)
Project Structure
mcp-itglue/
├── pyproject.toml # Project configuration
├── README.md # This file
└── src/
└── mcp_itglue/
├── __init__.py # Package initialization
├── server.py # Main MCP server
├── client.py # IT Glue API client with retry logic
├── config.py # Configuration management
└── tools/
├── __init__.py
├── organizations.py
├── configurations.py
├── passwords.py
├── contacts.py
├── flexible_assets.py
├── checklists.py
├── documents.py
├── locations.py
├── domains.py
├── related_items.py
└── reference_data.pyAdding New Resources
The modular architecture makes it easy to add new IT Glue resources:
Create a new file in
src/mcp_itglue/tools/(e.g.,ssl_certificates.py)Define a
register_*_tools(mcp, client)functionImport and export it in
tools/__init__.pyCall the registration function in
server.py
Example:
# src/mcp_itglue/tools/ssl_certificates.py
from mcp.server.fastmcp import FastMCP
from ..client import ITGlueClient, get_client
def register_ssl_certificate_tools(mcp: FastMCP, client: ITGlueClient | None = None) -> None:
client = client or get_client()
@mcp.tool()
async def list_ssl_certificates(organization_id: int | None = None) -> str:
"""List SSL certificates from IT Glue."""
# Implementation...Development
Running Tests
# Install dev dependencies
uv pip install -e ".[dev]"
# Run tests
pytestCode Formatting
ruff check .
ruff format .License
MIT License - see LICENSE for details.
Resources
Available Tools
105 toolsbrowser_closeA
Close the persistent browser if it's open.
Use this to manually close the browser when you're done with operations that require authentication. Only needed when browser persistence is enabled (browser_keep_open enabled=True).
Returns: Confirmation message
Inputs: no named parameters. Returns: result
browser_keep_openA
Enable or disable browser persistence after authentication.
When enabled (True), the browser window stays open after capturing authentication tokens. This is useful when you have multiple operations that need authentication - you only need to log in once per session.
When disabled (False, the default), the browser closes automatically after each authentication capture.
Args: enabled: True to keep browser open after auth, False to close it
Returns: Confirmation of the new setting
Inputs: enabled (required). Returns: result
browser_statusB
Check the current browser persistence status.
Returns information about:
Whether browser persistence is enabled
Whether a browser is currently open
Returns: JSON string with browser status
Inputs: no named parameters. Returns: result
complete_checklistC
Mark a checklist as completed.
Args: checklist_id: The checklist ID
Returns: JSON string with the updated checklist
Inputs: checklist_id (required). Returns: result
complete_checklist_task_jwtA
Mark a checklist task as completed using JWT authentication.
Args: task_id: Task ID to complete
Returns: JSON string with the updated task
Inputs: task_id (required). Returns: result
create_checklist_from_template_jwtA
Create a checklist from a template using JWT authentication.
This tool uses JWT authentication (captured from browser session) instead of API key authentication. This is REQUIRED for checklist creation because IT Glue's API key auth doesn't support it.
If no valid JWT token is cached, this will open a browser window for SAML authentication.
Args: organization_id: Organization ID checklist_template_id: Template ID to create from name: Optional custom name (uses template name if not provided) due_date: Due date in ISO format (YYYY-MM-DD) assignee_id: User ID to assign the checklist to
Returns: JSON string with the created checklist
Inputs: organization_id (required), checklist_template_id (required), name, due_date, +1 more. Returns: result
create_checklist_jwtA
Create a new checklist using JWT authentication.
This tool uses JWT authentication (captured from browser session) instead of API key authentication. This is REQUIRED for checklist creation because IT Glue's API key auth doesn't support it.
If no valid JWT token is cached, this will open a browser window for SAML authentication.
Args: organization_id: Organization ID (required) name: Checklist name description: Checklist description checklist_template_id: Optional template ID to create from due_date: Due date in ISO format (YYYY-MM-DD) assignee_id: User ID to assign the checklist to restricted: Whether the checklist is restricted
Returns: JSON string with the created checklist
Inputs: name (required), organization_id (required), due_date, restricted, +3 more. Returns: result
create_checklist_task_jwtA
Create a new task on a checklist using JWT authentication.
This tool uses JWT authentication (captured from browser session) instead of API key authentication. This is REQUIRED for task creation because IT Glue's public API doesn't expose the checklist_tasks POST endpoint.
If no valid JWT token is cached, this will open a browser window for SAML authentication.
Args: checklist_id: Checklist ID to add the task to (required) name: Task name (required) description: Task description due_date: Due date in ISO format (YYYY-MM-DD) assignee_id: User ID to assign the task to position: Position/order of the task in the list completed: Whether the task is already completed (default: False)
Returns: JSON string with the created task
Inputs: name (required), checklist_id (required), due_date, position, +3 more. Returns: result
create_configurationC
Create a new configuration (device/asset) in IT Glue.
Args: organization_id: Organization ID (required) name: Configuration name (required) configuration_type_id: Configuration type ID (required) hostname: Device hostname primary_ip: Primary IP address mac_address: MAC address serial_number: Serial number asset_tag: Asset tag configuration_status_id: Configuration status ID manufacturer_id: Manufacturer ID model_id: Model ID operating_system_id: Operating system ID operating_system_notes: OS notes notes: General notes
Returns: JSON string with the created configuration
Inputs: name (required), organization_id (required), configuration_type_id (required), notes, +10 more. Returns: result
create_contactC
Create a new contact in IT Glue.
Args: organization_id: Organization ID (required) first_name: Contact first name (required) last_name: Contact last name (required) contact_type_id: Contact type ID location_id: Location ID title: Job title important: Whether this is an important contact notes: Additional notes contact_emails: List of email objects with 'value' and optional 'label_name', 'primary' contact_phones: List of phone objects with 'value' and optional 'label_name', 'primary', 'extension'
Returns: JSON string with the created contact
Inputs: last_name (required), first_name (required), organization_id (required), notes, +6 more. Returns: result
create_documentA
Create a new document in IT Glue.
Args: organization_id: Organization ID (required) name: Document name/title (required) content: Document content as HTML (required) document_folder_id: Optional folder ID to place document in public: Whether the document is publicly visible (default False)
Returns: JSON string with the created document
Inputs: name (required), content (required), organization_id (required), public, +1 more. Returns: result
create_document_jwtA
Create a new document with content using session authentication.
This tool uses session authentication (cookies + XSRF token from browser) to create documents with content. This is REQUIRED because IT Glue's public API doesn't persist document content.
Two-step process:
Creates document shell via JWT/API
Adds content via internal web API
If no valid session is cached, this will return an error asking you to run the session capture script.
Args: organization_id: Organization ID (required) name: Document name/title (required) content: Document content as HTML (required) document_folder_id: Optional folder ID to place document in public: Whether the document is publicly visible (default False)
Returns: JSON string with the created document
Inputs: name (required), content (required), organization_id (required), public, +1 more. Returns: result
create_flexible_assetA
Create a new flexible asset.
Args: organization_id: Organization ID (required) flexible_asset_type_id: Flexible asset type ID (required) traits: Dictionary of field values matching the type's schema. Keys should match field names, values should match field types.
Returns: JSON string with the created flexible asset
Inputs: traits (required), organization_id (required), flexible_asset_type_id (required). Returns: result
create_locationB
Create a new location.
Args: organization_id: Organization ID (required) name: Location name (required) address_1: Street address line 1 address_2: Street address line 2 city: City name region_id: Region/state ID postal_code: Postal/ZIP code country_id: Country ID phone: Phone number fax: Fax number notes: Additional notes primary: Whether this is the primary location
Returns: JSON string with the created location
Inputs: name (required), organization_id (required), fax, city, +8 more. Returns: result
create_organizationB
Create a new organization in IT Glue.
Args: name: Organization name (required) description: Organization description organization_type_id: Organization type ID organization_status_id: Organization status ID quick_notes: Quick notes for the organization
Returns: JSON string with the created organization
Inputs: name (required), description, quick_notes, organization_type_id, +1 more. Returns: result
create_passwordA
Create a new password entry in IT Glue.
Args: organization_id: Organization ID (required) name: Password entry name (required) password: The password value (required) username: Associated username url: Associated URL password_category_id: Password category ID password_folder_id: Password folder ID notes: Additional notes resource_type: Related resource type (e.g., 'Configuration') resource_id: Related resource ID otp_secret: TOTP secret key (Base32 encoded, min 16 chars) for 2FA
Returns: JSON string with the created password entry (password value not included)
Inputs: name (required), password (required), organization_id (required), url, +7 more. Returns: result
delete_checklistsA
Delete multiple checklists.
Args: checklist_ids: List of checklist IDs to delete
Returns: JSON string with deletion confirmation
Inputs: checklist_ids (required). Returns: result
delete_checklist_task_jwtB
Delete a checklist task using JWT authentication.
This tool uses JWT authentication because IT Glue's public API doesn't support task deletion.
Args: task_id: Task ID to delete
Returns: JSON string with deletion confirmation
Inputs: task_id (required). Returns: result
delete_contactC
Delete a contact from IT Glue.
Args: contact_id: The IT Glue contact ID
Returns: JSON string with deletion confirmation
Inputs: contact_id (required). Returns: result
delete_documentA
Delete a document from IT Glue.
Args: document_id: The document ID to delete
Returns: JSON string with deletion confirmation
Inputs: document_id (required). Returns: result
delete_flexible_assetC
Delete a flexible asset.
Args: asset_id: The flexible asset ID
Returns: JSON string with deletion confirmation
Inputs: asset_id (required). Returns: result
delete_locationC
Delete a location.
Args: location_id: The location ID
Returns: JSON string with deletion confirmation
Inputs: location_id (required). Returns: result
delete_passwordB
Delete a password entry from IT Glue.
Args: password_id: The IT Glue password ID
Returns: JSON string with deletion confirmation
Inputs: password_id (required). Returns: result
get_all_reference_dataA
Get all reference data in a single call.
This is useful for caching reference data locally or understanding what options are available. Returns the first page of each type.
Returns: JSON string with all reference data types
Inputs: no named parameters. Returns: result
get_checklistA
Get a specific checklist by ID.
Args: checklist_id: The checklist ID include_tasks: Whether to include checklist tasks
Returns: JSON string with checklist details
Inputs: checklist_id (required), include_tasks. Returns: result
get_checklist_templateB
Get a specific checklist template by ID.
Args: template_id: The checklist template ID
Returns: JSON string with template details
Inputs: template_id (required). Returns: result
get_configurationC
Get a specific configuration by ID.
Args: configuration_id: The IT Glue configuration ID
Returns: JSON string with configuration details
Inputs: configuration_id (required). Returns: result
get_configuration_relationshipsA
Get all items related to a specific configuration (device/asset).
This is a convenience method for a common use case.
Args: configuration_id: The configuration ID
Returns: JSON string with all related items
Inputs: configuration_id (required). Returns: result
get_contactA
Get a specific contact by ID.
Args: contact_id: The IT Glue contact ID
Returns: JSON string with contact details
Inputs: contact_id (required). Returns: result
get_contact_relationshipsA
Get all items related to a specific contact.
This is a convenience method for a common use case.
Args: contact_id: The contact ID
Returns: JSON string with all related items
Inputs: contact_id (required). Returns: result
get_documentB
Get a specific document by ID.
Args: document_id: The document ID
Returns: JSON string with document details including content
Inputs: document_id (required). Returns: result
get_document_folderC
Get a specific document folder by ID.
Args: folder_id: The document folder ID
Returns: JSON string with folder details
Inputs: folder_id (required). Returns: result
get_domainB
Get a specific domain by ID.
Args: domain_id: The domain ID
Returns: JSON string with domain details
Inputs: domain_id (required). Returns: result
get_flexible_assetC
Get a specific flexible asset by ID.
Args: asset_id: The flexible asset ID
Returns: JSON string with the flexible asset details including all traits
Inputs: asset_id (required). Returns: result
get_flexible_asset_relationshipsC
Get all items related to a specific flexible asset.
This is a convenience method for a common use case.
Args: flexible_asset_id: The flexible asset ID
Returns: JSON string with all related items
Inputs: flexible_asset_id (required). Returns: result
get_flexible_asset_typeB
Get a specific flexible asset type by ID.
Args: type_id: The flexible asset type ID include_fields: Whether to include field definitions
Returns: JSON string with the flexible asset type details
Inputs: type_id (required), include_fields. Returns: result
get_locationA
Get a specific location by ID.
Args: location_id: The location ID
Returns: JSON string with location details
Inputs: location_id (required). Returns: result
get_organizationB
Get a specific organization by ID.
Args: organization_id: The IT Glue organization ID
Returns: JSON string with organization details
Inputs: organization_id (required). Returns: result
get_organization_checklistsB
Get all checklists for a specific organization.
Args: organization_id: The organization ID completed: Filter by completion status include_tasks: Whether to include checklist tasks page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with the organization's checklists
Inputs: organization_id (required), page, completed, page_size, +3 more. Returns: result
get_organization_documentsA
Get all documents for a specific organization.
Args: organization_id: The organization ID folder_id: Optional folder filter page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with the organization's documents
Inputs: organization_id (required), page, folder_id, page_size, +2 more. Returns: result
get_organization_domainsA
Get all domains for a specific organization.
Args: organization_id: The organization ID page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with the organization's domains
Inputs: organization_id (required), page, page_size, save_to_file, +1 more. Returns: result
get_organization_flexible_assetsA
Get all flexible assets for an organization.
Args: organization_id: The organization ID flexible_asset_type_id: Optional filter by type include_archived: Whether to include archived assets page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with the organization's flexible assets
Inputs: organization_id (required), page, page_size, save_to_file, +3 more. Returns: result
get_organization_locationsA
Get all locations for a specific organization.
Args: organization_id: The organization ID page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with the organization's locations
Inputs: organization_id (required), page, page_size, save_to_file, +1 more. Returns: result
get_passwordA
Get a specific password by ID.
Args: password_id: The IT Glue password ID show_password: Whether to include the actual password value
Returns: JSON string with password details
Inputs: password_id (required), show_password. Returns: result
jwt_clear_tokenA
Clear the cached JWT token.
Use this if you need to re-authenticate with a different account or if the token is causing issues.
Returns: Confirmation message
Inputs: no named parameters. Returns: result
jwt_token_statusA
Check the status of the cached JWT token.
Returns information about the currently cached JWT token including whether it's valid, when it expires, and the authenticated user.
Returns: JSON string with token status
Inputs: no named parameters. Returns: result
list_checklistsA
List checklists from IT Glue.
Args: organization_id: Filter by organization ID completed: Filter by completion status assignee_id: Filter by assignee user ID checklist_template_id: Filter by template ID include_tasks: Whether to include checklist tasks page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of checklists
Inputs: page, completed, page_size, assignee_id, +5 more. Returns: result
list_checklist_templatesA
List all checklist templates.
Checklist templates are reusable checklists that can be instantiated for specific organizations. Use these template IDs when creating checklists with create_checklist(checklist_template_id=...).
Args: page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of checklist templates
Inputs: page, page_size, save_to_file, output_format. Returns: result
list_configurationsA
List configurations (devices/assets) from IT Glue.
Args: organization_id: Filter by organization ID name: Filter by configuration name (partial match) hostname: Filter by hostname primary_ip: Filter by primary IP address serial_number: Filter by serial number configuration_type_id: Filter by configuration type ID configuration_status_id: Filter by configuration status ID page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of configurations
Inputs: name, page, hostname, page_size, +7 more. Returns: result
list_configuration_statusesA
List all configuration statuses.
Configuration statuses indicate the state of a device/asset (e.g., Active, Inactive, Decommissioned).
Args: name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of configuration statuses
Inputs: name, page, page_size. Returns: result
list_configuration_typesA
List all configuration types.
Configuration types categorize devices/assets (e.g., Server, Workstation, Network Device, Printer).
Args: name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of configuration types
Inputs: name, page, page_size. Returns: result
list_contactsA
List contacts from IT Glue.
Args: organization_id: Filter by organization ID first_name: Filter by first name (partial match) last_name: Filter by last name (partial match) title: Filter by job title (partial match) contact_type_id: Filter by contact type ID important: Filter by important flag page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of contacts
Inputs: page, title, important, last_name, +6 more. Returns: result
list_contact_typesA
List all contact types.
Contact types categorize contacts (e.g., Primary, Technical, Billing, Emergency).
Args: name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of contact types
Inputs: name, page, page_size. Returns: result
list_countriesB
List all countries.
Countries are used when specifying location addresses.
Args: name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of countries
Inputs: name, page, page_size. Returns: result
list_document_foldersA
List document folders from IT Glue.
Args: organization_id: Filter by organization ID parent_folder_id: Filter by parent folder ID page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of document folders
Inputs: page, page_size, save_to_file, output_format, +2 more. Returns: result
list_documentsA
List documents from IT Glue.
Args: organization_id: Filter by organization ID name: Filter by document name (partial match) document_folder_id: Filter by folder ID page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of documents
Inputs: name, page, page_size, save_to_file, +3 more. Returns: result
list_domainsA
List domains from IT Glue.
Args: organization_id: Filter by organization ID name: Filter by domain name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of domains
Inputs: name, page, page_size, save_to_file, +2 more. Returns: result
list_expiring_domainsA
List domains expiring within a specified number of days.
Args: days: Number of days to look ahead (default 30) organization_id: Optional organization filter page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with domains expiring soon
Inputs: days, page, page_size, save_to_file, +2 more. Returns: result
list_flexible_asset_fieldsA
List field definitions for a flexible asset type.
Note: This uses the include mechanism on the flexible asset type endpoint since IT Glue doesn't expose a direct /flexible_asset_fields filter endpoint.
Args: flexible_asset_type_id: The flexible asset type ID output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of field definitions including name_key for trait mapping
Inputs: flexible_asset_type_id (required), save_to_file, output_format. Returns: result
list_flexible_assetsA
List flexible asset instances.
Args: flexible_asset_type_id: Filter by flexible asset type organization_id: Filter by organization name: Filter by name (partial match) archived: Filter by archived status page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of flexible assets
Inputs: name, page, archived, page_size, +4 more. Returns: result
list_flexible_asset_typesA
List all flexible asset type definitions (schemas).
Flexible asset types define the structure/schema for custom documentation like "Server Documentation", "Network Diagrams", "Vendor Contacts", etc.
Args: enabled: Filter by enabled status page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of flexible asset types
Inputs: page, enabled, page_size, save_to_file, +1 more. Returns: result
list_incomplete_checklistsA
List incomplete checklists, optionally filtered by organization.
Args: organization_id: Optional organization ID filter overdue_only: If True, only return checklists past their due date page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of incomplete checklists
Inputs: page, page_size, overdue_only, save_to_file, +2 more. Returns: result
list_locationsB
List locations from IT Glue.
Args: organization_id: Filter by organization ID name: Filter by location name (partial match) city: Filter by city region_id: Filter by region/state ID country_id: Filter by country ID primary: Filter by primary location status page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of locations
Inputs: city, name, page, primary, +6 more. Returns: result
list_manufacturersA
List all manufacturers.
Manufacturers are used when creating configurations to specify the device manufacturer (e.g., Dell, HP, Cisco).
Args: name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of manufacturers
Inputs: name, page, page_size. Returns: result
list_modelsB
List all models.
Models are used when creating configurations to specify the device model (e.g., PowerEdge R740, ProLiant DL380).
Args: manufacturer_id: Filter by manufacturer ID name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of models
Inputs: name, page, page_size, manufacturer_id. Returns: result
list_operating_systemsA
List all operating systems.
Operating systems are used when creating configurations to specify the device's OS (e.g., Windows Server 2019, Ubuntu 22.04).
Args: name: Filter by name (partial match) platform: Filter by platform (e.g., 'Windows', 'Linux', 'macOS') page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of operating systems
Inputs: name, page, platform, page_size. Returns: result
list_organizationsA
List organizations from IT Glue.
Args: name: Filter by organization name (partial match) organization_type_id: Filter by organization type ID organization_status_id: Filter by organization status ID page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of organizations
Inputs: name, page, page_size, save_to_file, +3 more. Returns: result
list_organization_statusesA
List all organization statuses.
Organization statuses indicate the state of an organization (e.g., Active, Inactive, Onboarding).
Args: name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of organization statuses
Inputs: name, page, page_size. Returns: result
list_organization_typesA
List all organization types.
Organization types categorize organizations (e.g., Customer, Prospect, Vendor, Internal).
Args: name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of organization types
Inputs: name, page, page_size. Returns: result
list_password_categoriesA
List all password categories.
Password categories organize passwords by type (e.g., Admin, User, Service Account, API Key).
Args: name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of password categories
Inputs: name, page, page_size. Returns: result
list_passwordsA
List passwords from IT Glue (without password values).
Args: organization_id: Filter by organization ID name: Filter by password name (partial match) password_category_id: Filter by password category ID url: Filter by URL page: Page number (starts at 1) page_size: Number of results per page (max 1000) output_format: Output format - "full" (all fields), "compact" (key fields only), or "summary" (counts and IDs only). Default: compact save_to_file: If True, saves full results to a temp file and returns the path for jq processing
Returns: JSON string with list of passwords (password values not included)
Inputs: url, name, page, page_size, +4 more. Returns: result
list_regionsA
List regions/states for a country.
Regions are used when specifying location addresses.
Args: country_id: Country ID to get regions for name: Filter by name (partial match) page: Page number (starts at 1) page_size: Number of results per page (max 1000)
Returns: JSON string with list of regions
Inputs: country_id (required), name, page, page_size. Returns: result
search_configurationsA
Search for configurations by name or hostname.
Args: query: Search query string (matches name or hostname) organization_id: Optional organization ID to limit search limit: Maximum number of results (default 10, max 100) output_format: Output format - "full", "compact" (default), or "summary" save_to_file: If True, saves full results to a temp file for jq processing
Returns: JSON string with matching configurations
Inputs: query (required), limit, save_to_file, output_format, +1 more. Returns: result
search_contactsA
Search for contacts by name.
Args: query: Search query string (searches first and last name) organization_id: Optional organization ID to limit search limit: Maximum number of results (default 10, max 100) output_format: Output format - "full", "compact" (default), or "summary" save_to_file: If True, saves full results to a temp file for jq processing
Returns: JSON string with matching contacts
Inputs: query (required), limit, save_to_file, output_format, +1 more. Returns: result
search_documentsB
Search for documents by name.
Args: query: Search query string organization_id: Optional organization filter limit: Maximum number of results (default 10, max 100) output_format: Output format - "full", "compact" (default), or "summary" save_to_file: If True, saves full results to a temp file for jq processing
Returns: JSON string with matching documents
Inputs: query (required), limit, save_to_file, output_format, +1 more. Returns: result
search_domainsA
Search for domains by name.
Args: query: Search query string organization_id: Optional organization filter limit: Maximum number of results (default 10, max 100) output_format: Output format - "full", "compact" (default), or "summary" save_to_file: If True, saves full results to a temp file for jq processing
Returns: JSON string with matching domains
Inputs: query (required), limit, save_to_file, output_format, +1 more. Returns: result
search_flexible_assetsA
Search for flexible assets by name.
Args: query: Search query string flexible_asset_type_id: Optional type filter organization_id: Optional organization filter limit: Maximum number of results (default 10, max 100) output_format: Output format - "full", "compact" (default), or "summary" save_to_file: If True, saves full results to a temp file for jq processing
Returns: JSON string with matching flexible assets
Inputs: query (required), limit, save_to_file, output_format, +2 more. Returns: result
search_locationsB
Search for locations by name.
Args: query: Search query string organization_id: Optional organization filter limit: Maximum number of results (default 10, max 100) output_format: Output format - "full", "compact" (default), or "summary" save_to_file: If True, saves full results to a temp file for jq processing
Returns: JSON string with matching locations
Inputs: query (required), limit, save_to_file, output_format, +1 more. Returns: result
search_manufacturersB
Search for manufacturers by name.
Args: query: Search query string limit: Maximum number of results (default 10, max 100)
Returns: JSON string with matching manufacturers
Inputs: query (required), limit. Returns: result
search_modelsA
Search for models by name.
Args: query: Search query string manufacturer_id: Optional manufacturer filter limit: Maximum number of results (default 10, max 100)
Returns: JSON string with matching models
Inputs: query (required), limit, manufacturer_id. Returns: result
search_operating_systemsA
Search for operating systems by name.
Args: query: Search query string limit: Maximum number of results (default 10, max 100)
Returns: JSON string with matching operating systems
Inputs: query (required), limit. Returns: result
search_organizationsA
Search for organizations by name.
Args: query: Search query string limit: Maximum number of results (default 10, max 100) output_format: Output format - "full", "compact" (default), or "summary" save_to_file: If True, saves full results to a temp file for jq processing
Returns: JSON string with matching organizations
Inputs: query (required), limit, save_to_file, output_format. Returns: result
search_passwordsA
Search for passwords by name.
Args: query: Search query string organization_id: Optional organization ID to limit search limit: Maximum number of results (default 10, max 100) output_format: Output format - "full", "compact" (default), or "summary" save_to_file: If True, saves full results to a temp file for jq processing
Returns: JSON string with matching passwords (password values not included)
Inputs: query (required), limit, save_to_file, output_format, +1 more. Returns: result
session_browser_closeA
Close the persistent Chromium browser if it's open.
Use this to manually close the browser when you're done with document operations that require session authentication. Only needed when browser persistence is enabled.
Returns: Confirmation message
Inputs: no named parameters. Returns: result
session_browser_keep_openA
Enable or disable browser persistence for session authentication.
When enabled (True), the Chromium browser window stays open after capturing session data. This is useful when you have multiple document operations - you only need to log in once per session.
When disabled (False, the default), the browser closes automatically after each session capture.
Note: This is separate from jwt_browser_keep_open which controls the Chromium browser for JWT/checklist operations.
Args: enabled: True to keep browser open after auth, False to close it
Returns: Confirmation of the new setting
Inputs: enabled (required). Returns: result
session_browser_statusA
Check the current session browser persistence status.
Returns information about:
Whether browser persistence is enabled for session auth
Whether a Chromium browser is currently open
Returns: JSON string with browser status
Inputs: no named parameters. Returns: result
session_clearA
Clear the cached session for document operations.
Use this if you need to re-authenticate or if the session is causing issues.
Returns: Confirmation message
Inputs: no named parameters. Returns: result
session_statusA
Check the status of the cached session for document operations.
Returns information about the currently cached session including tenant subdomain and age.
Note: This checks for cached session data but cannot validate server-side session state. If operations fail with auth errors, run capture_session.sh to re-authenticate.
Returns: JSON string with session status
Inputs: no named parameters. Returns: result
uncomplete_checklistB
Mark a checklist as incomplete.
Args: checklist_id: The checklist ID
Returns: JSON string with the updated checklist
Inputs: checklist_id (required). Returns: result
uncomplete_checklist_task_jwtA
Mark a checklist task as not completed using JWT authentication.
Args: task_id: Task ID to mark as incomplete
Returns: JSON string with the updated task
Inputs: task_id (required). Returns: result
update_checklistC
Update an existing checklist.
Args: checklist_id: The checklist ID name: New checklist name description: New checklist description completed: Mark checklist as completed/incomplete due_date: New due date (YYYY-MM-DD) assignee_id: New assignee user ID restricted: New restricted status
Returns: JSON string with the updated checklist
Inputs: checklist_id (required), name, due_date, completed, +3 more. Returns: result
update_checklist_task_jwtA
Update an existing checklist task using JWT authentication.
This tool uses JWT authentication because IT Glue's public API doesn't support task modification.
Args: task_id: Task ID to update (required) name: New task name description: New task description due_date: New due date in ISO format (YYYY-MM-DD) assignee_id: New assignee user ID position: New position/order in the list completed: New completion status
Returns: JSON string with the updated task
Inputs: task_id (required), name, due_date, position, +3 more. Returns: result
update_configurationB
Update an existing configuration in IT Glue.
Args: configuration_id: The IT Glue configuration ID name: New configuration name hostname: New hostname primary_ip: New primary IP address mac_address: New MAC address serial_number: New serial number asset_tag: New asset tag configuration_type_id: New configuration type ID configuration_status_id: New configuration status ID manufacturer_id: New manufacturer ID model_id: New model ID operating_system_id: New operating system ID operating_system_notes: New OS notes notes: New general notes
Returns: JSON string with the updated configuration
Inputs: configuration_id (required), name, notes, hostname, +10 more. Returns: result
update_contactC
Update an existing contact in IT Glue.
Args: contact_id: The IT Glue contact ID first_name: New first name last_name: New last name contact_type_id: New contact type ID location_id: New location ID title: New job title important: New important flag notes: New notes contact_emails: New list of email objects contact_phones: New list of phone objects
Returns: JSON string with the updated contact
Inputs: contact_id (required), notes, title, important, +6 more. Returns: result
update_documentC
Update an existing document.
Args: document_id: The document ID name: New document name content: New document content document_folder_id: New folder ID public: New public visibility status
Returns: JSON string with the updated document
Inputs: document_id (required), name, public, content, +1 more. Returns: result
update_document_jwtA
Update an existing document's content using session authentication.
This tool uses session authentication (cookies + XSRF token from browser) to update document content. This is REQUIRED because IT Glue's public API doesn't persist document content.
If no valid session is cached, this will return an error asking you to run the session capture script.
Args: organization_id: Organization ID (required - needed for internal API) document_id: The document ID (required) name: Document name (required - needed for update) content: New document content as HTML (required) public: Whether the document is publicly visible (default False)
Returns: JSON string with the updated document
Inputs: name (required), content (required), document_id (required), organization_id (required), +1 more. Returns: result
update_flexible_assetA
Update an existing flexible asset.
Args: asset_id: The flexible asset ID traits: Updated field values (merged with existing traits) archived: Set archived status
Returns: JSON string with the updated flexible asset
Inputs: asset_id (required), traits, archived. Returns: result
update_locationB
Update an existing location.
Args: location_id: The location ID name: New location name address_1: New street address line 1 address_2: New street address line 2 city: New city name region_id: New region/state ID postal_code: New postal/ZIP code country_id: New country ID phone: New phone number fax: New fax number notes: New notes primary: New primary status
Returns: JSON string with the updated location
Inputs: location_id (required), fax, city, name, +8 more. Returns: result
update_organizationA
Update an existing organization in IT Glue.
Args: organization_id: The IT Glue organization ID name: New organization name description: New organization description organization_type_id: New organization type ID organization_status_id: New organization status ID quick_notes: New quick notes
Returns: JSON string with the updated organization
Inputs: organization_id (required), name, description, quick_notes, +2 more. Returns: result
update_passwordA
Update an existing password entry in IT Glue.
Args: password_id: The IT Glue password ID name: New password entry name password: New password value username: New username url: New URL password_category_id: New password category ID password_folder_id: New password folder ID notes: New notes otp_secret: TOTP secret key (Base32 encoded, min 16 chars) for 2FA
Returns: JSON string with the updated password entry (password value not included)
Inputs: password_id (required), url, name, notes, +5 more. Returns: result
upload_file_to_itglueA
Upload a file to IT Glue Documents (GlueFiles).
This uploads a file to an organization's Documents section using session authentication. Supports any file type.
If no valid session is cached, this will return an error asking you to run the session capture script.
Args: organization_id: Organization ID to upload to (required) file_path: Local path to the file to upload (required) filename: Override filename (optional, defaults to original filename)
Returns: JSON string with upload result
Inputs: file_path (required), organization_id (required), filename. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 105 tools
The core list/get/search/create/update/delete tools are distinct, but multiple pairs overlap: create_document/create_document_jwt and update_document/update_document_jwt appear to do the same thing with different auth mechanisms, and get_organization_* tools duplicate list_* with an organization filter. With 105 tools, an agent can easily select the wrong variant.
Most resource tools follow a clear list_/get_/search_/create_/update_/delete_ pattern, but auth/session utilities like jwt_clear_token, session_clear, and browser_keep_open break the verb_noun convention. The _jwt suffix is also applied inconsistently, as seen in create_checklist_jwt versus update_checklist, and delete_checklists uses a plural form.
105 tools is far beyond the typical MCP scope and includes many overlapping auth variants, convenience wrappers, and list-versus-get duplicates. Even a comprehensive IT Glue integration could express this surface with far fewer tools.
Core resources like contacts, passwords, configurations, flexible assets, locations, and documents have strong CRUD coverage, but organizations and configurations lack delete operations and domains are read-only. Several valid resource types such as tickets and SSL certificates are absent except as related-item references.
Related MCP Connectors
Read and write KukGit repositories, files, issues and pull requests from an AI assistant.
Manage tickets, run agents and workflows, query tables, and search workspace knowledge.
Connect assistants to your workspace knowledge, skills, and work tools.
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn unofficial Model Context Protocol server that enables AI assistants to manage ITGlue documents, sections, and organizations via the ITGlue API. It supports full CRUD operations, organization lookups, and regional API endpoints for US, EU, and Australia.28 npm5MIT
- AlicenseAqualityBmaintenanceConnects AI assistants to IT Glue, the MSP documentation platform. Browse organizations, read and write documents and flexible assets, and answer natural-language questions via semantic vector search (OpenAI/Azure embeddings). Viewer/editor/admin roles gate tool access; bring-your-own-key applies IT Glue's native permissions. Runs over stdio or HTTP; Docker image available.27119 npm6MIT
- AlicenseAqualityCmaintenanceProvides Claude with access to IT Glue documentation and asset management, enabling searching and retrieval of organizations, configurations, passwords, documents, and more.24Apache 2.0

hudu-mcpofficial
AlicenseAqualityDmaintenanceEnables AI assistants to interact with Hudu IT documentation, providing tools for companies, assets, knowledge base articles, credentials, IPAM, racks, and more, with security gates for passwords and destructive operations.7012 npmMIT