| name | intercom-install-auth |
| description | 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".
|
| allowed-tools | Write, Bash(npm:*) |
| version | 1.6.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","support","messaging","intercom"] |
| compatibility | Designed for Claude Code |
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
npm install intercom-client
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):
import { IntercomClient } from "intercom-client";
const client = new IntercomClient({
token: process.env.INTERCOM_ACCESS_TOKEN!,
});
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:
const admins = await client.admins.list();
console.log("Connected! Admins:", admins.admins.length);
The complete verification function (with error handling and expected output) is in examples.md.
Step 4: OAuth Setup (Public Apps)
