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"
      }
    }
  }
}

3. 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 <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 ITGLUE_API_KEY=your-key ghcr.io/junto-platforms/itglue-mcp-server:latest

Health check

curl http://localhost:3000/health

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally (stdio)
ITGLUE_API_KEY=your-key node dist/index.js

# Run locally (HTTP)
ITGLUE_API_KEY=your-key node dist/index.js --transport http

# Development with auto-reload
ITGLUE_API_KEY=your-key npm run dev

# Development with HTTP transport
ITGLUE_API_KEY=your-key npm run dev:http

# Run tests
npm test

Sponsored by Junto

Secure client access, automated ticket resolution, and intelligent IT operations. Discover how Junto is transforming MSP service delivery at juntoai.com.

License

MIT