Log inSubmit server
MCP Itglue logo

MCP Itglue

by selic

Connects AI assistants to IT Glue for documentation search, record management, uploads, indexing, and role-controlled writes.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Itglue

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "selic-mcp-itglue": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-itglue"
      ],
      "env": {
        "ITGLUE_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

selic/mcp-itglue MCP server connects AI clients to the IT Glue API for reading and modifying MSP documentation, flexible assets, images, and attachments. It supports semantic vector search with OpenAI or Azure OpenAI embeddings, a local JSON index, stdio, and streamable HTTP transport. Reach for it when an assistant needs governed access to IT Glue records, documentation maintenance, or searchable operational runbooks.

Use cases

  • Search IT Glue runbooks by meaning rather than exact wording
  • Read organizations, documents, sections, assets, and attachments
  • Create or update documentation and flexible assets
  • Upload images into document sections or record attachments
  • Restrict destructive operations to administrator sessions

Key features

  • Semantic vector search with OpenAI or Azure OpenAI embeddings
  • Document, section, and flexible-asset read/write operations
  • Document image and attachment upload support
  • Viewer, editor, and admin role-based tool access
  • Server-wide or per-session IT Glue API keys
  • Stdio and streamable HTTP transports

Tools9

What MCP Itglue lets your agent do. Expand a tool for its parameters.

Self-reported~72 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/20 checks healthy over the last 84d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · mcp-itglue (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars5Stargazers on the source repository.
Last commit1mo agoMost recent push to the default branch.
Tools exposed9Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Itglue works

What selic/mcp-itglue does

selic/mcp-itglue MCP server exposes IT Glue operations through Model Context Protocol. It covers organizations, documents, document folders and sections, flexible asset types and records, document images, attachments, and vector-search indexes. Read tools can retrieve records and files, while write tools can create or update supported records, publish documents, add images or attachments, and rebuild the search index.

The server also includes destructive operations for deleting documents, flexible assets, attachments, document images, or document sections. These capabilities are separated into read, write, and destructive tiers so deployments can assign different access levels to viewers, editors, and administrators.

How it works

For local use, the server runs over stdio and exposes its full tool surface to the connected client. For shared deployments, it runs over streamable HTTP with an MCP endpoint, health check, webhook route for incremental IT Glue index updates, and a manual refresh route. HTTP sessions are kept in memory, so a deployment should use one instance or provide sticky sessions behind a load balancer.

Semantic search uses OpenAI or Azure OpenAI embeddings and stores the resulting index in local JSON. The index can be refreshed manually, updated through an IT Glue webhook, or refreshed after writes.

HTTP access can use bearer tokens assigned to viewer, editor, or admin roles. Tools unavailable to a role are omitted from that session, and calls are checked again at runtime. Clients can also provide an IT Glue API key per session through the supported header when BYOK is enabled. IT Glue permissions then determine access for that client key.

Setup and configuration

selic/mcp-itglue MCP server requires an IT Glue API key supplied through ITGLUE_API_KEY for the standard server-wide configuration. Accounts outside the United States can set ITGLUE_REGION to eu or au. The package can run with npx, from a source checkout after building, or in the provided Docker image.

Use stdio for a local Claude Desktop or Claude Code configuration. Docker defaults to HTTP and can expose port 3000. HTTP deployments can configure comma-separated label:token values with MCP_TOKENS_VIEWER, MCP_TOKENS_EDITOR, and MCP_TOKENS_ADMIN. If no role tokens are configured, the server grants admin access in development mode and emits a warning; this is not suitable for production.

BYOK behavior is controlled by CLIENT_ITGLUE_KEYS, which accepts with-token, open, or disabled. HTTP deployments can also enable staged uploads so clients transfer larger files directly before a tool attaches or embeds them.

Tools and capabilities

Available tool groups include:

  • Listing and retrieving organizations, documents, folders, sections, flexible asset types, flexible assets, images, and attachments.
  • Searching the vector index and checking its status.
  • Creating, updating, publishing, and deleting supported document content.
  • Creating and updating flexible assets.
  • Creating and deleting document images and attachments.
  • Building the vector index and using endpoint discovery or a general IT Glue GET operation.

Attachments appear in an IT Glue record’s Attachments panel and do not render inside document content. Images intended for a document body use the document-image tools instead. An image can be supplied as base64, a URL, or a local path; HTTP staged uploads are available for larger files.

Limitations and notes

Base64 transfer is intended only for small files because model tool arguments can become too large for screenshots or other substantial media. Staged upload slots are temporary, tied to the requesting principal, and consumed once. Document image content must use the returned relative resource path or a public HTTPS URL; IT Glue removes data URIs and its own S3 URLs from section content.

The server’s destructive tools permanently remove selected records or files, so deployments should assign them only to trusted roles. HTTP sessions are held in memory, and the server-wide IT Glue key is optional only when the chosen BYOK policy requires clients to provide their own key.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Itglue

selic/mcp-itglue is an MCP server that connects AI clients to the IT Glue API. Its main tools read and modify documents, sections, flexible assets, images, and attachments, while vector-search tools find relevant documentation. It also supports index rebuilding, role-based access, bearer-token sessions, and per-session IT Glue keys.

Install it with npx, Docker, or from source. For a local setup, configure an MCP client to run `npx -y mcp-itglue` and provide `ITGLUE_API_KEY`. The Docker image defaults to HTTP, while passing `--transport stdio` runs it as a local stdio server.

Configure `MCP_TOKENS_VIEWER`, `MCP_TOKENS_EDITOR`, and `MCP_TOKENS_ADMIN` with comma-separated label-and-token pairs for HTTP deployments. Viewers receive read tools, editors also receive write tools, and admins receive destructive tools. Without configured tokens, the server runs with admin access in development mode.

Yes. Use document-image tools for pictures embedded in document content and attachment tools for files in a record’s Attachments panel. Small files can use base64, URLs, or local paths; HTTP staged uploads are available when transferring larger files.

Yes. Claude Desktop can run the server through an `mcpServers` configuration using npx and `ITGLUE_API_KEY`, or users can open the provided `.mcpb` release package. Claude Code is also supported through its MCP configuration or command-line setup.

Related MCP servers

All in Support & Service Management All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Itglue AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/selic-mcp-itglue?style=directory)](https://allmcps.com/mcp/selic-mcp-itglue)
HTML Embed
<a href="https://allmcps.com/mcp/selic-mcp-itglue"><img src="https://allmcps.com/api/badge/selic-mcp-itglue?style=directory" alt="MCP Itglue on AllMCPs" /></a>