@mindstone-engineering/mcp-server-outreach

Outreach sales engagement MCP server — prospects, sequences, accounts, tasks, and mailings via Outreach API.

Installation

npx -y @mindstone-engineering/mcp-server-outreach

Configuration

OAuth Mode (Recommended)

Set these environment variables to use standalone OAuth authentication:

OUTREACH_CLIENT_ID=your_client_id
OUTREACH_CLIENT_SECRET=your_client_secret

Then call the outreach_connect_account tool to initiate the OAuth flow.

Manual Token Mode

If you have a static access token:

OUTREACH_ACCESS_TOKEN=your_access_token

Optional Settings

OUTREACH_CONFIG_DIR=~/.mcp/outreach    # Custom config directory (default: ~/.mcp/outreach)
OUTREACH_OAUTH_PORT=0                   # OAuth callback port (default: OS-assigned)
OUTREACH_OAUTH_SCOPES="prospects.all sequences.all accounts.all users.read tasks.all mailings.read"

Available Tools (15)

Account Management

• outreach_connect_account — Connect an Outreach account via OAuth
• outreach_list_connected_accounts — List connected accounts and auth status
• outreach_disconnect_account — Disconnect an account and remove credentials

Prospects

• outreach_search_prospects — Search prospects by name, email, company, tags
• outreach_get_prospect — Get full prospect details by ID
• outreach_create_prospect — Create a new prospect
• outreach_update_prospect — Update an existing prospect

Sequences

• outreach_list_sequences — List sequences with filters
• outreach_get_sequence — Get sequence details by ID
• outreach_add_prospect_to_sequence — Enroll a prospect in a sequence

Accounts (Companies)

• outreach_list_accounts — List company accounts
• outreach_get_account — Get company account details by ID

Tasks

• outreach_list_tasks — List tasks with status and prospect filters

Mailings

• outreach_list_mailings — List sent emails with delivery status

Users

• outreach_list_users — List Outreach team members

Auth Modes

The connector supports four authentication modes, detected once at startup:

| Mode | Detection | Description | |------|-----------|-------------| | bridge | MCP_HOST_BRIDGE_STATE set | Host app manages OAuth | | standalone_oauth | OUTREACH_CLIENT_ID + OUTREACH_CLIENT_SECRET set | Local OAuth with browser redirect | | manual_token | OUTREACH_ACCESS_TOKEN set | Static access token | | unconfigured | No auth env vars | Tools return setup guidance |

Precedence: bridge > standalone_oauth > manual_token > unconfigured

License

FSL-1.1-MIT