InboxJoyAgents & API
Connect Claude, ChatGPT, or Cursor
By the end of this page, your AI agent can use InboxJoy through its remote MCP server.
Connect your AI agent
InboxJoy is a remote MCP server. You do not need to build a separate integration.
Add the connector URL
Open your agent’s connector or MCP server settings and paste this URL:
https://inboxjoy.online/mcpSign in to InboxJoy
Follow the redirect to InboxJoy. Sign in and choose the workspace the agent can access.
Approve the requested permissions
Review the exact permissions before you approve them. No API key is involved. The connection stays authorized until you revoke it in Settings → MCP → Connected apps.
Review the requested scopes
Every connection requests one or both scopes. InboxJoy shows each scope by name when you approve access.
| Scope | What it allows |
|---|---|
inboxjoy:read | Read your campaigns and sending data. |
inboxjoy:write | Create campaigns and send on your behalf. |
Use InboxJoy MCP tools
InboxJoy exposes every operation as an MCP tool named inboxjoy_<area>_<action>. Your agent can use about 57 tools.
| Tool | What it does |
|---|---|
inboxjoy_leads_import | Imports up to 1,000 leads at once, optionally into a named list. |
inboxjoy_sequences_draft | Drafts a multi-step sequence from a description. |
inboxjoy_campaigns_create | Creates a draft campaign from a sequence, list, and inbox. |
inboxjoy_campaigns_launch | Publishes a campaign and enrolls every eligible contact. |
inboxjoy_campaigns_get | Gets per-step analytics and enrollment status counts. |
inboxjoy_analytics_summary | Gets workspace delivery analytics and daily time series. |
inboxjoy_export_csv | Exports leads, suppressions, or campaign results as CSV. |
The full set covers leads, campaigns and sequences, sending analytics, suppressions, templates, search, notifications, and workspace and team read access. Read-scoped tools are available with inboxjoy:read alone. Write actions require inboxjoy:write.
Ask your agent to complete a task
The tools map directly to InboxJoy operations. You can ask your agent:
- “Import this list of 80 leads from my CRM export into a list called Q3 outbound.”
- “Draft a 4-step sequence for operations leaders about reducing manual lead routing.”
- “Launch that campaign to the Q3 outbound list from my main inbox.”
- “How is the campaign performing so far?”
Revoke an agent’s access
Open Settings → MCP. Find the app and review the scopes on its active OAuth grant. Click Revoke to invalidate its tokens immediately.