# Intercom Conversations

> Clawhub Skill: Intercom Conversations (Read)

- Skill: `javimosch/intercom-conversations` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/intercom-conversations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/intercom-conversations/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/intercom-conversations

---

# Clawhub Skill: Intercom Conversations (Read)

Clawhub loads this Node module and calls `default(input)`.

## Required env

- `INTERCOM_ACCESS_TOKEN` (required)

## Install

```bash
npm install
```

## Inputs

### List
```json
{ "action": "conversations.list", "per_page": 50, "starting_after": "cursor" }
```

### Find
```json
{ "action": "conversations.find", "conversation_id": "123", "display_as": "plaintext" }
```

### Search
```json
{ "action": "conversations.search", "query": { "operator": "AND", "value": [] }, "pagination": { "per_page": 50 } }
```

## Outputs

All successful responses include `ok: true` and echo the `action`.

- list/search: `{ ok, action, conversations, next_starting_after }`
- find: `{ ok, action, conversation }`

Errors: `{ ok: false, error, supported_actions? }`

## Contracts / metadata

- OpenAPI spec: `openapi.yaml`
- Skill registry metadata: `clawhub.skill.json`