itglue

This MCP server provides a bridge to ITGlue's API, exposing 13 tools to manage ITGlue documents, document sections, and organizations via the MCP protocol. It supports full CRUD operations for documents and their sections, publishing documents, and looking up organizations by ID. The server can respond in Markdown or JSON, and supports both stdio and HTTP transports, as well as regional endpoints (US, EU, AU). To use it, start the server in your preferred transport mode and point your MCP client at the server's /mcp endpoint when using HTTP transport. For Quick Start, the server is typically run with npx itglue-mcp-server and an API key supplied via ITGLUE_API_KEY, with optional region and transport flags as needed.

Prerequisites:

• Node.js and npm installed on your machine
• An ITGlue API key (ITGLUE_API_KEY)

1. Install dependencies and build (from repository root)

npm install
npm run build

2. Run locally with stdio transport (default port 3000)

ITGLUE_API_KEY=your-key node dist/index.js

3. Run with HTTP transport (HTTP REST/streaming) on port 3000

ITGLUE_API_KEY=your-key node dist/index.js --transport http --port 3000

4. Alternate run using npm scripts (development with auto-reload)

ITGLUE_API_KEY=your-key npm run dev

5. Docker-based deployment (optional):

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

Notes:

• If you need a different region, add --region eu or --region au to the CLI (when starting with npx or node, see usage in docs).
• You can override base URL with ITGLUE_BASE_URL if you need a custom ITGlue API host.

Environment variables and configuration:

• ITGLUE_API_KEY: Required API key for ITGlue access
• ITGLUE_BASE_URL: Optional custom ITGlue base URL (default uses regional endpoints)
• TRANSPORT: Set to stdio or http (default is stdio)
• PORT: HTTP server port (default 3000)

CLI options to remember: --api-key, --base-url, --region, --transport, --port, --help, --version

Common issues:

• Ensure the ITGLUE_API_KEY is valid and has the necessary permissions
• When using HTTP transport, ensure the port is open and reachable by clients
• If the API base URL is wrong, ITGlue requests will fail; verify the region setting

Tools exposed include:

• Organizations: itglue_list_organizations, itglue_get_organization
• Documents: itglue_list_documents, itglue_get_document, itglue_create_document, itglue_update_document, itglue_publish_document, itglue_delete_documents
• Document Sections: itglue_list_document_sections, itglue_get_document_section, itglue_create_document_section, itglue_update_document_section, itglue_delete_document_section

Regional support:

• US (default): https://api.itglue.com
• EU: https://api.eu.itglue.com
• AU: https://api.au.itglue.com