IT Glue MCP Server

A Model Context Protocol (MCP) server for IT Glue API integration. Enables LLMs to interact with IT Glue documentation including organizations, configurations, passwords, contacts, flexible assets, and more.

Features

• Organizations: List, get, create, update organizations
• Configurations: Manage IT assets (servers, workstations, network devices)
• Passwords: Credential management (with optional password access)
• Contacts: Manage people associated with organizations
• Flexible Assets: Custom documentation types with dynamic fields
• Locations: Physical addresses for organizations
• Domains: Domain registration tracking
• Expirations: Track warranties, certificates, and renewals

Installation

npm install
npm run build

Configuration

Environment Variables

Getting an API Key

1. Log into IT Glue as an Administrator
2. Go to Account > Settings > API Keys
3. Click + Custom API Key
4. Give it a name and optionally enable Password Access
5. Copy the generated key

Note: API keys expire after 90 days of inactivity.

Password Access

The IT Glue API has a separate permission for password access. If your API key doesn't have this permission:

• You can still list and search passwords
• You can create and update passwords
• You cannot retrieve actual password values

Use the itglue_check_password_access tool to verify your access level.

Usage with Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "itglue": {
      "command": "node",
      "args": ["C:/Users/Dan/GitHub/itglue-mcp-server/dist/index.js"],
      "env": {
        "ITGLUE_API_KEY": "ITG.your-api-key-here"
      }
    }
  }
}

Available Tools

Organizations

• itglue_list_organizations - List organizations with filtering
• itglue_get_organization - Get organization by ID
• itglue_create_organization - Create new organization
• itglue_update_organization - Update existing organization

Configurations

• itglue_list_configurations - List configurations (devices/assets)
• itglue_get_configuration - Get configuration by ID
• itglue_create_configuration - Create new configuration
• itglue_update_configuration - Update existing configuration

Passwords

• itglue_list_passwords - List passwords
• itglue_get_password - Get password by ID (includes value if permitted)
• itglue_create_password - Create new password entry
• itglue_update_password - Update existing password
• itglue_check_password_access - Check if API key has password access

Contacts

• itglue_list_contacts - List contacts
• itglue_get_contact - Get contact by ID
• itglue_create_contact - Create new contact
• itglue_update_contact - Update existing contact

Flexible Assets

• itglue_list_flexible_assets - List flexible assets
• itglue_get_flexible_asset - Get flexible asset by ID
• itglue_create_flexible_asset - Create new flexible asset
• itglue_update_flexible_asset - Update existing flexible asset
• itglue_list_flexible_asset_types - List all flexible asset types
• itglue_get_flexible_asset_type - Get flexible asset type with fields
• itglue_list_flexible_asset_fields - List fields for a type

Locations

• itglue_list_locations - List locations
• itglue_get_location - Get location by ID
• itglue_create_location - Create new location
• itglue_update_location - Update existing location

Domains

• itglue_list_domains - List domains
• itglue_get_domain - Get domain by ID

Expirations

• itglue_list_expirations - List upcoming expirations

Response Formats

All tools support two response formats via the response_format parameter:

• markdown (default) - Human-readable formatted output
• json - Structured JSON for programmatic use

Pagination

List endpoints support pagination:

• page - Page number (1-indexed)
• page_size - Items per page (max 1000, default 50)

Response includes pagination metadata:

• total_count - Total items available
• has_more - Whether more pages exist
• next_page - Next page number (if available)

Rate Limits

IT Glue allows 3000 requests per 5-minute window. The server will return a clear error message if you hit the rate limit.

API Regions

IT Glue has separate API endpoints by region:

Set the ITGLUE_REGION environment variable to match your account's region.

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode with auto-reload
npm run dev

# Clean build artifacts
npm run clean

License

MIT