Agent skill · software engineering · jeremylongshore
intercom-install-auth
Install and configure Intercom API authentication with access tokens or OAuth. Use when setting up a new Intercom integration, configuring API credentials, or initializing the intercom-client SDK in your project. Trigger with phrases like "install intercom", "setup intercom", "intercom auth", "configure intercom API key", "intercom access token".
Why this skill is useful
Adds specific commands and configuration patterns for integrating with the Intercom API that the AI wouldn't reliably generate on its own.
What it needs
Requires node, npm installed locally. Requires intercom account access. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Intercom Install & Auth Overview Set up the official intercom-client TypeScript SDK and configure authentication via access tokens (private apps) or OAuth (public apps). This skill installs the SDK with a Bash npm command, uses Write to create the client config and .env, and verifies the connection. Prerequisites Node.js 18+ npm, pnpm, or yarn Intercom workspace with Developer Hub access Access token from Configure > Authentication in your app settings Instructions Step 1: Install the SDK The package exports IntercomClient and all TypeScript types under the Intercom namespace. Step 2: Configure Access Token Authentication Access tokens authenticate private apps that access your own Intercom workspace. Use Write to create the client module and a .env holding the token (add .env to .gitignore): See examples.md for the full .env setup and secure-storage steps. Step 3: Verify Connection List admins to confirm the token authenticates end-to-end: The complete verification function (with error handling and expected output) is in examples.md. Step 4: OAuth Setup (Public Apps) For a public app that accesses other workspaces, run the OAuth authorization → token-exchange flow, then initialize the client with the returned token: Full OAuth exchange, API-version pinning, and the scope matrix are in oauth.md. Output Running this skill produces: intercom-client installed in nodemodules and added to package.json. A configured IntercomClient module authenticated via access token or OAuth. A .env holding INTERCOMACCESSTOKEN (private app) or INTERCOMCLIENTID / INTERCOMCLIENTSECRET (OAuth), with .env gitignored. A verified connection — client.admins.list() returns your workspace admins, confirming the token and API version (2.11, applied automatically by the SDK) are correct. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/intercom-install-auth