communication
Intercom MCP, CLI, and Lua Integration for AI Agents
Intercom integration docs for AI agents: MCP gateway setup, Intercom CLI commands, Lua API reference, credentials, and function schemas.
7 functions 6 read 1 write Bearer token auth
Intercom for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Machine-Readable Metadata
- integration_slug
intercom- route_slug
intercom- package
intercom- auth_strategy
bearer_tokenBearer token- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
true
Quick Links
Lua APIAgent-facing namespace and function reference. Intercom CLIHeadless setup and direct function calls. Intercom MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.
Intercom MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Intercom.
Claude Code Intercom MCP setup for Claude Code. Cursor Intercom MCP setup for Cursor. Codex Intercom MCP setup for Codex. OpenAI Agents Intercom MCP setup for OpenAI Agents SDK. Claude Agent SDK Intercom MCP setup for Claude Agent SDK. Vercel AI SDK Intercom MCP setup for Vercel AI SDK. LangChain Intercom MCP setup for LangChain. LangGraph Intercom MCP setup for LangGraph. CrewAI Intercom MCP setup for CrewAI. MCP clients Intercom MCP setup for Generic MCP Clients.
Intercom CLI Matrix
Use these pages for direct Intercom CLI workflows in scripts, CI, cron, and agent wrappers.
CI Intercom CLI for CI. Cron Jobs Intercom CLI for cron jobs. Shell Scripts Intercom CLI for shell scripts. Headless Automation Intercom CLI for headless automation. Coding Agents Intercom CLI for coding agents.
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
intercom.intercom_list_conversations | Read read | 4 | List Intercom conversations with pagination and sorting. Returns conversation IDs, created dates, and state. Use limit, starting_after, and sort_order for pagination and ordering. |
intercom.intercom_get_conversation | Read read | 1 | Retrieve an Intercom conversation by its ID. Returns the full conversation including message parts, contacts, and metadata. |
intercom.intercom_create_conversation | Write write | 2 | Create a new conversation in Intercom. Requires a user_id (Intercom contact ID) and a message body. Returns the created conversation with its ID. |
intercom.intercom_list_contacts | Read read | 2 | List Intercom contacts with pagination. Returns contact IDs, emails, names, and roles. Use limit and starting_after for pagination. |
intercom.intercom_get_contact | Read read | 1 | Retrieve an Intercom contact by its ID. Returns the contact's ID, email, name, phone, role, and custom attributes. |
intercom.intercom_list_companies | Read read | 2 | List Intercom companies with pagination. Returns company IDs, names, and employee counts. Use limit and starting_after for pagination. |
intercom.intercom_get_current_user | Read read | 0 | Retrieve the currently authenticated Intercom admin user. Returns the admin's ID, name, email, and avatar. Useful for identifying which workspace or token is in use. |