Manage sequences, contacts, and outreach statistics on Reply.io's sales engagement platform.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
Reply.io MCP Server
Connect Reply.io to your AI client and let it work across your team and workspace.
reply.io · Documentation
Overview
A remote MCP server at mcp.reply.io that lets MCP-compatible AI clients — Claude, ChatGPT, Cursor, Codex, and more — work with your Reply.io CRM and AI SDR. One connection gives an agent a catalog of tools spanning contacts, sequences, inbox, tasks, analytics, and the AI SDR ("Jason"), so it can read and act on Reply data without making direct HTTP requests. The tools run the same logic as the Reply.io API and the in-app AI assistant.
No local installation required. Free for all Reply.io users.
📖 Full documentation: docs.reply.io/reply-mcp
Where this fits
Reply's agentic toolkit is three pieces. They are complementary, not alternatives:
| What it is | When you want it | |
|---|---|---|
| reply CLI | npm i -g reply-cli — authenticated access to every v3 endpoint via reply api | Your agent has a shell. This is the complete surface. |
| Reply MCP (this repo) | A curated tool catalog over mcp.reply.io | Your client speaks MCP and has no shell — desktop apps, hosted assistants. |
| reply-skills | Outbound expertise as markdown skills: what to do, in what order, with what guardrails | Your agent knows how to call things but not what to run. |
MCP gives your agent tools. Skills give it judgement. Most setups want both; a shell-capable agent can do everything through the CLI alone.
The shortest path that works: install the CLI, reply auth login, reply skills install, then
talk to your agent in plain words. MCP is optional — add it when your client has no shell.
Connect
Reply MCP is a remote server at https://mcp.reply.io. Authenticate with a scoped personal API key (recommended) or OAuth, then add it to your client.
Claude Code
Desktop apps (Claude, ChatGPT)
Add Reply MCP as a remote / custom connector using the URL https://mcp.reply.io and authorize with OAuth.
Create and scope a key under Settings → API Key in your Reply.io dashboard.
Note: Passing credentials in the URL (for example
?api_key=...) is not supported. Always authenticate with theAuthorizationheader or OAuth.
- Full connection guide (Codex,
mcp-remoteproxy, OAuth): docs.reply.io/reply-mcp#connect - Authentication & keys: docs.reply.io/reply-mcp#authentication
Authentication & scopes
Reply MCP authenticates as a single Reply.io user, via one of two methods:
- Personal API key (recommended) — passed as
Authorization: Bearer <token>. A personal key is scoped: you grant it only the permissions your agent needs, and it can call only the tools those permissions cover. - OAuth — authorize directly from the client, no key to copy. OAuth grants the full tool catalog (all scopes).
Each tool requires a single scope such as contacts:read or sequences:operate; a key can call a tool only if it holds that scope. Act-on-behalf keys (Team and Organization keys) are not supported on this single-user connection.
See the full scope list at docs.reply.io/api-reference/authentication#scopes.
Tools
71 tools across your CRM and AI SDR. ⚠️ marks destructive tools (create / update / delete / send / assign) — these require the matching :write or :operate scope and carry a destructiveHint so conforming clients can prompt for confirmation. Call arguments (the JSON input schema) are advertised live via tools/list; the tables below describe what each tool is for.
Contacts & lists
| Tool | Purpose |
|---|---|
reply_search_contacts | Look up contacts by exact email or LinkedIn URL |
reply_filter_contacts | List contacts by list/sequence membership or a name/email/company search |
reply_get_contact_activity | Get a contact's activity history (emails, LinkedIn, calls, events) |
⚠️ reply_create_contact | Create a contact |
⚠️ reply_update_contact | Patch fields on an existing contact |
⚠️ reply_change_contact_owner | Reassign contacts to another team member |
⚠️ reply_mark_contacts_as_replied | Flag/unflag contacts as replied (stops automated outreach) |
⚠️ reply_blacklist_contact | Blacklist a contact's email or whole domain |
reply_search_lists | Resolve contact lists to their numeric IDs by name |
Sequences
| Tool | Purpose |
|---|---|
reply_search_sequences | Find sequences by name, status, or archive state |
reply_list_schedules | List sending schedules (business-hours windows) |
reply_get_sequence_steps | Get a sequence's ordered steps (type, delay, variant count) |
reply_get_sequence_step_variants | Get a step's A/B content variants |
⚠️ reply_change_status_in_sequence | Set a contact's status within a sequence |
⚠️ reply_add_contact_to_sequence | Enroll contacts into a sequence |
⚠️ reply_start_sequence | Start or resume a sequence |
⚠️ reply_pause_sequence | Pause a sequence |
⚠️ reply_assign_email_account_to_sequence | Attach an email account (mailbox) to a sequence |
⚠️ reply_assign_linkedin_account_to_sequence | Attach a LinkedIn account to a sequence |
⚠️ reply_assign_schedule_to_sequence | Set a sequence's sending schedule |
Analytics
| Tool | Purpose |
|---|---|
reply_get_sequence_stats | Email + LinkedIn performance for one sequence, over any date range |
reply_compare_sequence_performance | Compare performance across multiple sequences side by side |
Inbox
| Tool | Purpose |
|---|---|
reply_get_inbox_emails | List inbox threads (email + LinkedIn) with short previews |
⚠️ reply_send_inbox_reply | Send a reply on an existing inbox thread |
⚠️ reply_change_inbox_category | Set or clear a thread's category |
Tasks
| Tool | Purpose |
|---|---|
reply_list_my_tasks | List your tasks, filtered by type, status, due window, or contact |
⚠️ reply_create_task | Create a manual task |
⚠️ reply_complete_task | Mark a task as completed |
Channels & accounts
| Tool | Purpose |
|---|---|
reply_list_email_accounts | List workspace email accounts (status, daily limit, tags) |
reply_list_linkedin_accounts | List connected LinkedIn accounts (status, health, tier) |
Team
| Tool | Purpose |
|---|---|
reply_search_team_members | Resolve teammates to their numeric user IDs by name or email |
Help & workspace
| Tool | Purpose |
|---|---|
reply_diagnose | Explain why a sequence isn't sending and how to fix it |
reply_get_app_map | Catalog of Reply.io app areas and what the assistant can do in each |
reply_search_knowledge_base | Search the Reply.io Help Center for how-to answers |
reply_get_knowledge_base_article | Read a full Help Center article by slug |
reply_report_unsupported_request | Report a missing capability to the product team |
AI SDR — Offers
| Tool | Purpose |
|---|---|
reply_list_offers | List AI SDR offers (what Jason can pitch) |
reply_get_offer | Get one offer in full |
⚠️ reply_create_offer | Create a new offer |
⚠️ reply_update_offer | Patch an existing offer |
⚠️ reply_attach_offer_to_sequence | Attach an offer to an AI SDR sequence |
reply_generate_offer_from_website | Draft offer content from a company website (review only, saves nothing) |
AI SDR — Playbooks
| Tool | Purpose |
|---|---|
reply_list_playbooks | List playbooks (named sets of selling instructions) |
reply_get_playbook | Get one playbook in full |
⚠️ reply_create_playbook | Create a new playbook |
⚠️ reply_update_playbook | Patch an existing playbook |
⚠️ reply_duplicate_playbook | Duplicate a playbook |
⚠️ reply_attach_playbook_to_sequence | Attach a playbook to an AI SDR sequence |
AI SDR — Knowledge bases
| Tool | Purpose |
|---|---|
reply_list_knowledge_bases | List AI SDR knowledge bases |
reply_get_knowledge_base | Get one knowledge base in full (with URL sources) |
⚠️ reply_create_knowledge_base | Create a knowledge base |
⚠️ reply_update_knowledge_base | Rename or set a knowledge base's instructions |
⚠️ reply_add_knowledge_base_source | Add a web-page URL as a source |
⚠️ reply_delete_knowledge_base_source | Remove a URL source |
⚠️ reply_attach_knowledge_base_to_sequence | Attach a knowledge base to an AI SDR sequence |
AI SDR — Reply handlers
| Tool | Purpose |
|---|---|
reply_list_reply_handlers | List reply handlers in a knowledge base |
reply_get_reply_handler | Get one reply handler in full |
⚠️ reply_create_reply_handler | Add a reply handler (how Jason answers a kind of question) |
⚠️ reply_update_reply_handler | Patch a reply handler |
⚠️ reply_delete_reply_handler | Remove a reply handler |
AI SDR — Re-engagement cards
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Reply.io
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/reply-io)HTML Embed
<a href="https://allmcps.com/mcp/reply-io"><img src="https://allmcps.com/api/badge/reply-io?style=directory" alt="Reply.io on AllMCPs" /></a>