Outreach — Claude Code MCP server: what it does, how to install
Connects AI assistants to the Outreach API to manage prospects, sequences, mailings, and sales tasks.
claude mcp add --env OUTREACH_CLIENT_ID=<OUTREACH_CLIENT_ID> --env OUTREACH_CLIENT_SECRET=<OUTREACH_CLIENT_SECRET> --env OUTREACH_ACCESS_TOKEN=<OUTREACH_ACCESS_TOKEN> --env OUTREACH_CONFIG_DIR=<OUTREACH_CONFIG_DIR> --env OUTREACH_OAUTH_PORT=<OUTREACH_OAUTH_PORT> --transport stdio outreach -- npx -y @mindstone/mcp-server-outreachWhat Outreach does
This server provides 22 tools to interact with Outreach sales resources. The model can look up prospects by email or tags, read profile attributes across custom fields custom1 to custom35, check sender mailboxes, and inspect call logs.
It supports automated outreach sequence workflows. The assistant can view step email templates, enroll prospects into sequences, or pause active enrollments. Authentication works through host bridge mode, browser-based OAuth with OUTREACH_CLIENT_ID and OUTREACH_CLIENT_SECRET, or a static OUTREACH_ACCESS_TOKEN.
Every resource ID must be purely numeric. Supplying an alphanumeric ID fails validation immediately with VALIDATION_ERROR, stopping invalid requests before reaching the API.
What it helps with
- search prospects by email, name, company, or tags
- enroll leads into sales outreach sequences
- schedule and complete CRM tasks with due dates
- inspect call outcomes and delivery status of sent mailings
Example prompts for the agent
- Search Outreach for contacts matching the domain acme.corp
- Enroll prospect 9481 into sequence 302 using mailbox 12
- Mark task 5512 as completed in Outreach
How to install Outreach
Platform CLI
claude mcp add --env OUTREACH_CLIENT_ID=<OUTREACH_CLIENT_ID> --env OUTREACH_CLIENT_SECRET=<OUTREACH_CLIENT_SECRET> --env OUTREACH_ACCESS_TOKEN=<OUTREACH_ACCESS_TOKEN> --env OUTREACH_CONFIG_DIR=<OUTREACH_CONFIG_DIR> --env OUTREACH_OAUTH_PORT=<OUTREACH_OAUTH_PORT> --transport stdio outreach -- npx -y @mindstone/mcp-server-outreachReplace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
codex mcp add outreach --env OUTREACH_CLIENT_ID=<OUTREACH_CLIENT_ID> --env OUTREACH_CLIENT_SECRET=<OUTREACH_CLIENT_SECRET> --env OUTREACH_ACCESS_TOKEN=<OUTREACH_ACCESS_TOKEN> --env OUTREACH_CONFIG_DIR=<OUTREACH_CONFIG_DIR> --env OUTREACH_OAUTH_PORT=<OUTREACH_OAUTH_PORT> -- npx -y @mindstone/mcp-server-outreachReplace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"mcpServers": {
"outreach": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-outreach"
],
"env": {
"OUTREACH_CLIENT_ID": "<OUTREACH_CLIENT_ID>",
"OUTREACH_CLIENT_SECRET": "<OUTREACH_CLIENT_SECRET>",
"OUTREACH_ACCESS_TOKEN": "<OUTREACH_ACCESS_TOKEN>",
"OUTREACH_CONFIG_DIR": "<OUTREACH_CONFIG_DIR>",
"OUTREACH_OAUTH_PORT": "<OUTREACH_OAUTH_PORT>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Config file
{
"servers": {
"outreach": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-outreach"
],
"env": {
"OUTREACH_CLIENT_ID": "<OUTREACH_CLIENT_ID>",
"OUTREACH_CLIENT_SECRET": "<OUTREACH_CLIENT_SECRET>",
"OUTREACH_ACCESS_TOKEN": "<OUTREACH_ACCESS_TOKEN>",
"OUTREACH_CONFIG_DIR": "<OUTREACH_CONFIG_DIR>",
"OUTREACH_OAUTH_PORT": "<OUTREACH_OAUTH_PORT>"
}
}
}
}Replace <…> with your own values. 1 more environment variable is in the server README
Platform CLI
gemini mcp add -e OUTREACH_CLIENT_ID=<OUTREACH_CLIENT_ID> -e OUTREACH_CLIENT_SECRET=<OUTREACH_CLIENT_SECRET> -e OUTREACH_ACCESS_TOKEN=<OUTREACH_ACCESS_TOKEN> -e OUTREACH_CONFIG_DIR=<OUTREACH_CONFIG_DIR> -e OUTREACH_OAUTH_PORT=<OUTREACH_OAUTH_PORT> outreach npx -y @mindstone/mcp-server-outreachReplace <…> with your own values. 1 more environment variable is in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Outreach
How to install Outreach in Claude Code?
Run `claude mcp add mcp-server-outreach -e OUTREACH_CLIENT_ID=<OUTREACH_CLIENT_ID> -e OUTREACH_CLIENT_SECRET=<OUTREACH_CLIENT_SECRET> -e OUTREACH_ACCESS_TOKEN=<OUTREACH_ACCESS_TOKEN> -- npx -y @mindstone/mcp-server-outreach` in your terminal. Replace the placeholder values with your credentials.
What does the Outreach MCP server do?
It exposes 22 API tools to manage Outreach contacts, company accounts, sequence enrollments, sender mailboxes, and sales follow-up tasks.
What ID format does the server require?
All resource identifiers like prospect and sequence IDs must contain digits only. Non-numeric values trigger an immediate VALIDATION_ERROR before sending any network request.
