Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .antigravity-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"name": "intercom",
"displayName": "Intercom",
"version": "0.2.0",
"description": "Search Intercom conversations, contacts, and companies, spot support trends, and install the Intercom Messenger with secure identity verification.",
"logo": "assets/logo.svg",
"suggestedPrompts": [
"Show me the most common topics in open Intercom conversations this week",
"Summarize every Intercom conversation from jane@example.com",
"Install the Intercom Messenger in this app with identity verification"
],
"keywords": ["intercom", "fin", "customer-support", "helpdesk", "conversations", "contacts", "messenger", "crm"],
"author": {
"name": "Fin",
"url": "https://fin.ai"
},
"homepage": "https://developers.intercom.com",
"repository": "https://github.com/intercom/claude-plugin-external",
"license": "MIT"
}
12 changes: 9 additions & 3 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,19 @@
{
"name": "intercom",
"description": "Intercom integration for Claude Code. Search conversations, analyze customer support patterns, look up contacts and companies, and install the Intercom Messenger. Connect your Intercom workspace to get real-time insights from customer data.",
"version": "0.1.0",
"version": "0.2.0",
"author": {
"name": "Intercom",
"url": "https://intercom.com"
"name": "Fin",
"url": "https://fin.ai"
},
"homepage": "https://developers.intercom.com",
"repository": "https://github.com/intercom/claude-plugin-external",
"license": "MIT",
"mcpServers": {
"intercom": {
"type": "http",
"url": "https://mcp.intercom.com/mcp"
}
},
"keywords": ["intercom", "customer-support", "conversations", "contacts", "messenger", "crm", "api"]
}
6 changes: 0 additions & 6 deletions .mcp.json

This file was deleted.

7 changes: 5 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co

## What This Is

Intercom plugin for Claude Code — a skill-based integration (not compiled code). Skills are pure Markdown files that Claude reads at runtime to interact with Intercom workspaces via a remote MCP server.
Intercom plugin for Claude Code and Google Antigravity — a skill-based integration (not compiled code). Skills are pure Markdown files the agent reads at runtime to interact with Intercom workspaces via a remote MCP server. Both platforms load the same `skills/` directory.

## Architecture

Expand All @@ -13,8 +13,11 @@ User → Claude Code CLI → Skill (SKILL.md) → MCP Server (https://mcp.interc
```

- **No build step, no dependencies, no tests.** The plugin is entirely declarative.
- `.mcp.json` routes the `intercom` namespace to the remote HTTP-based MCP server.
- `.claude-plugin/plugin.json` declares the `intercom` MCP server inline. Don't add a `.mcp.json`: Antigravity never loads it, and `agy plugin validate --strict` fails on it.
- `.claude-plugin/plugin.json` is the plugin manifest for Claude Code's plugin registry.
- `.antigravity-plugin/plugin.json` is the Antigravity Plugin Marketplace manifest. Antigravity reads MCP servers from `mcp_config.json` and the card logo from `assets/logo.svg`, both at the repo root.
- Keep `version` in both manifests in step, and bump it on every published change so installed clients pick up the update.
- The company is Fin and Intercom is its helpdesk product: use Fin for the publisher (`author`) and Intercom for the product and its features.
- `.claude/settings.local.json` manages local permissions (currently allows WebFetch from raw.githubusercontent.com).

## Skills
Expand Down
15 changes: 12 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,27 @@
# Intercom Plugin for Claude Code
# Intercom Plugin for Claude Code and Google Antigravity

Connect your Intercom workspace to Claude Code. Search conversations, analyze customer support patterns, look up contacts and companies, and install the Intercom Messenger — all from your terminal.
Connect your Intercom workspace to Claude Code or Google Antigravity. Search conversations, analyze customer support patterns, look up contacts and companies, and install the Intercom Messenger.

## Prerequisites

- An [Intercom](https://www.intercom.com) workspace
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI installed
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or [Google Antigravity](https://antigravity.google) installed
- Your Intercom workspace must be US-hosted (EU and AU support coming soon)

## Installation

### Claude Code

```
/plugin install intercom
```

### Google Antigravity

Open **Customizations → Plugins** and install Intercom from **Discover**, or choose **+ Install from URL** and enter `https://github.com/intercom/claude-plugin-external`.

Connecting to the Intercom MCP server requires signing in to your Intercom workspace through OAuth. In Antigravity, explicit skills are invoked without the `intercom:` prefix, for example `/customer-360 jane@example.com`.

## Available Skills

| Skill | Invocation | Description |
Expand Down Expand Up @@ -67,6 +75,7 @@ Pull up conversation #12345 and show me the full thread
- [Intercom API Reference](https://developers.intercom.com/docs/references/rest-api/api.intercom.io/conversations/conversation/)
- [Intercom Messenger Setup Guide](https://www.intercom.com/help/en/articles/170-install-intercom-on-your-website-or-web-app)
- [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)
- [Google Antigravity](https://antigravity.google)

## License

Expand Down
1 change: 1 addition & 0 deletions assets/logo.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
7 changes: 7 additions & 0 deletions mcp_config.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"mcpServers": {
"intercom": {
"serverUrl": "https://mcp.intercom.com/mcp"
}
}
}
Loading