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

Tools

Organizations

Documents

Document Sections

Regions

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

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

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

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.

License

MIT