KosmoKrator

productivity

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.

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.

Agent Surfaces

Intercom CLIHeadless setup, JSON output, direct function calls. Intercom MCPExpose selected tools to local MCP clients. Intercom LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug
intercom
route_slug
intercom
package
intercom
auth_strategy
bearer_token
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true

Function Catalog

FunctionTypeParametersDescription
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.