ITGlue MCP Server

Manage ITGlue documents, sections, and organizations via the ITGlue API.

README.md

itglue-mcp-server

An unofficial Model Context Protocol (MCP) server for the ITGlue API. Enables AI assistants to manage ITGlue documents, document sections, and organizations.

Note: This is an unofficial, community-maintained project and is not affiliated with or endorsed by Kaseya/ITGlue.

Features

  • 13 tools covering documents, document sections, and organizations
  • Full CRUD support for documents and document sections
  • Publish documents directly from your AI assistant
  • Organization lookup for finding org IDs
  • Pagination, filtering, and sorting support
  • Markdown and JSON response formats
  • Regional API support (US, EU, Australia)
  • Stdio and streaming HTTP transports
  • Docker support for containerized deployment

Quick Start

Claude Desktop

  1. Open Claude Desktop and go to Settings > Developer > Edit Config
  2. Add the following to claude_desktop_config.json:
{
  "mcpServers": {
    "itglue": {
      "command": "npx",
      "args": ["-y", "itglue-mcp-server"],
      "env": {
        "ITGLUE_API_KEY": "your-api-key-here"
      }
    }
  }
}
  1. Save the file and restart Claude Desktop

Config file locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Streaming HTTP

Start the server in HTTP mode:

ITGLUE_API_KEY=your-key npx itglue-mcp-server --transport http --port 3000

Then configure your MCP client:

{
  "mcpServers": {
    "itglue": {
      "type": "streamable-http",
      "url": "http://localhost:3000/mcp"
    }
  }
}

Other MCP Clients (Cursor, Windsurf, Claude Code, etc.)

Most MCP clients use the same stdio configuration format shown above.

EU or Australia Regions

Add --region eu or --region au to the args:

{
  "mcpServers": {
    "itglue": {
      "command": "npx",
      "args": ["-y", "itglue-mcp-server", "--region", "eu"],
      "env": {
        "ITGLUE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

Variable Description Required Default
ITGLUE_API_KEY ITGlue API key Yes
ITGLUE_BASE_URL Custom API base URL No https://api.itglue.com
TRANSPORT Transport mode: stdio or http No stdio
PORT HTTP server port No 3000

CLI Options

--api-key <key>         ITGlue API key (overrides env var)
--base-url <url>        Custom API base URL (overrides env var)
--region <region>       API region: us, eu, or au (default: us)
--transport <mode>      Transport mode: stdio or http (default: stdio)
--port            HTTP server port (default: 3000)
--help                  Show help
--version               Show version

Tools

Organizations

Tool Description
itglue_list_organizations Search and list organizations with filtering and pagination
itglue_get_organization Get detailed information about a specific organization

Documents

Tool Description
itglue_list_documents List documents globally or within an organization
itglue_get_document Get a document with all embedded sections
itglue_create_document Create a new draft document
itglue_update_document Update document metadata (name)
itglue_publish_document Publish a draft document
itglue_delete_documents Permanently delete one or more documents

Document Sections

Tool Description
itglue_list_document_sections List all sections in a document
itglue_get_document_section Get a specific section with full content
itglue_create_document_section Add a section (Text, Heading, Gallery, Step)
itglue_update_document_section Update section content, type, or position
itglue_delete_document_section Permanently delete a section

API Key Setup

  1. Log in to ITGlue as an Administrator
  2. Go to Account > Settings > API Keys
  3. Generate a new Custom API Key
  4. Copy the key and set it as ITGLUE_API_KEY

ITGlue automatically revokes API keys unused for 90+ days.

Regions

Region Base URL
US (default) https://api.itglue.com
EU https://api.eu.itglue.com
Australia https://api.au.itglue.com

Rate Limiting

The ITGlue API allows a maximum of 3,000 requests per 5-minute window. The server will return clear error messages if the rate limit is exceeded.

Docker

Build and run locally

docker build -t itglue-mcp-server .
docker run --rm -p 3000:3000 -e ITGLUE_API_KEY=your-key itglue-mcp-server

The Docker image runs in HTTP transport mode by default on port 3000.

Pre-built image

docker pull ghcr.io/junto-platforms/itglue-mcp-server:latest
docker run --rm -p 3000:3000 -e

Tools 13

itglue_list_organizationsSearch and list organizations with filtering and pagination
itglue_get_organizationGet detailed information about a specific organization
itglue_list_documentsList documents globally or within an organization
itglue_get_documentGet a document with all embedded sections
itglue_create_documentCreate a new draft document
itglue_update_documentUpdate document metadata (name)
itglue_publish_documentPublish a draft document
itglue_delete_documentsPermanently delete one or more documents
itglue_list_document_sectionsList all sections in a document
itglue_get_document_sectionGet a specific section with full content
itglue_create_document_sectionAdd a section (Text, Heading, Gallery, Step)
itglue_update_document_sectionUpdate section content, type, or position
itglue_delete_document_sectionPermanently delete a section

Environment Variables

ITGLUE_API_KEYrequiredITGlue API key
ITGLUE_BASE_URLCustom API base URL
TRANSPORTTransport mode: stdio or http
PORTHTTP server port

Try it

List all organizations in ITGlue to find the ID for my client.
Create a new draft document titled 'Network Infrastructure' for organization ID 12345.
Add a new text section to document 98765 with the content 'Server room access code is 1234'.
Publish the draft document with ID 98765.
Get the details of the document section with ID 555.

Frequently Asked Questions

What are the key features of ITGlue?

Full CRUD operations for ITGlue documents and sections. Support for regional API endpoints (US, EU, Australia). Organization lookup and document management. Supports both stdio and streaming HTTP transports. Docker-ready for containerized deployment.

What can I use ITGlue for?

Automating the creation of standard operating procedure (SOP) documents in ITGlue.. Quickly retrieving specific technical documentation or credentials during an incident response.. Syncing documentation updates from AI-generated reports directly into ITGlue.. Managing large-scale documentation updates across multiple client organizations..

How do I install ITGlue?

Install ITGlue by running: npx -y itglue-mcp-server

What MCP clients work with ITGlue?

ITGlue works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep ITGlue docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Open Conare