Content
# marketo-mcp-server
[](https://www.npmjs.com/package/marketo-mcp-server)
[](https://www.npmjs.com/package/marketo-mcp-server)
[](https://glama.ai/mcp/servers/ZLeventer/marketo-mcp-server)
[](https://nodejs.org)
[](https://modelcontextprotocol.io)
[](LICENSE)
**MCP server for Marketo — query leads, programs, emails, forms, lists, bulk exports, analytics, and admin utilities from Claude in plain English.**
45 tools covering leads (lookup, batch upsert, activity log, full timeline), programs (list, clone, clone with tokens, dead program reaper, status changes), emails (clone, send sample), forms (clone, approve), smart lists (search by filter type), static lists, channels, landing pages, bulk export, campaign analytics, and admin utilities (field browser, activity type reference, folder browser). Built for Marketo admins and marketing ops who'd rather ask a question than click through the UI.
---
## Why this exists
The Marketo Admin UI is slow, the REST API is fiddly (LaunchPoint, identity tokens, OAuth client-credentials, bulk export polling), and most teams don't have an internal tool layer over it. This server abstracts the auth, retries, and pagination so you can ask Claude things like *"which forms are approved on the Contact Us LP?"* or *"clone the Q1 webinar program into the Q2 folder"* and it just works.
No other open-source Marketo MCP server ships this depth (45 tools across 11 categories). Earned a [Glama AAA quality rating](https://glama.ai/mcp/servers/ZLeventer/marketo-mcp-server).
---
## Example prompts
Once installed, ask Claude things like:
- *"Show all leads created this week from the Webinar source."*
- *"What programs are currently active and what channel is each one under?"*
- *"Find all forms on the Contact Us landing page and show me their fields."*
- *"Clone the Q1 Webinar program into the Q2 folder and name it Q2 Webinar."*
- *"Export all leads updated in the last 30 days to CSV — email, firstName, lastName, company."*
- *"Send a sample of email ID 1234 to test@example.com rendered with lead 5678's data."*
- *"Show me the full activity timeline for jane.doe@acme.com over the last 90 days."*
- *"Clone the Q1 Content Asset program into Q2, and set the asset-url token to https://example.com/report and the send-date token to 2026-05-15."*
- *"Which campaigns drove the most email opens and form fills in the last 14 days?"*
- *"Show me the health of all our nurture programs — which ones haven't been updated in over 30 days?"*
- *"Map all the smart campaigns in program 1234 and show me what filters and triggers each one uses."*
- *"Find every smart campaign in our instance that fires on a form fill."*
- *"Which programs haven't been touched in 90 days and should be considered for archiving?"*
- *"What's the API name for the lead score field? Show me all scoring-related fields."*
- *"What activity type ID corresponds to clicking a link in an email?"*
- *"Show me the folder tree under Marketing Activities so I can find the right destination folder."*
- *"Mark lead IDs 1234 and 5678 as Attended in program 9999."*
---
## Demo
> 🎥 *Walkthrough video coming soon — exporting filtered leads from Marketo via Claude in under 60 seconds.*
---
## Features
| Category | What you can do |
|---|---|
| **Leads** | Get by ID or email, create/update in batch, delete, retrieve activity log |
| **Programs** | List, get by ID, clone, get members |
| **Emails** | List, get by ID, clone, send sample/test |
| **Forms** | List, get by ID, clone, approve |
| **Smart Lists** | List, get by ID with full filter definitions |
| **Static Lists** | Get members, add leads, remove leads |
| **Channels** | List, get by ID, create with progression statuses |
| **Landing Pages** | List, get by ID, clone |
| **Bulk Export** | Create job, enqueue, poll status, download file |
| **Analytics** | Lead activity timeline, clone program with tokens, rank campaigns by engagement, nurture health check, smart campaign dependency map, dead program reaper, search campaigns by filter |
| **Admin** | Lead field browser, activity type reference, folder browser, change program status |
---
## Prerequisites
- Node.js 20+
- A Marketo instance with REST API access
- A Marketo API-only user and LaunchPoint service with **Client ID** and **Client Secret**
---
## Setup
### 1. Get your Marketo REST credentials
In Marketo Admin: **Integration → LaunchPoint** → create or select a service → copy Client ID and Secret. Your base URL is under **Integration → Web Services** (e.g. `https://xxx-xxx-xxx.mktorest.com`).
### 2. Set environment variables
```bash
MARKETO_CLIENT_ID=your_client_id
MARKETO_CLIENT_SECRET=your_client_secret
MARKETO_BASE_URL=https://xxx-xxx-xxx.mktorest.com
```
---
## Usage
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
```json
{
"mcpServers": {
"marketo": {
"command": "npx",
"args": ["marketo-mcp-server"],
"env": {
"MARKETO_CLIENT_ID": "your_client_id",
"MARKETO_CLIENT_SECRET": "your_client_secret",
"MARKETO_BASE_URL": "https://xxx-xxx-xxx.mktorest.com"
}
}
}
}
```
### Claude Code
```bash
claude mcp add marketo-mcp-server npx marketo-mcp-server \
-e MARKETO_CLIENT_ID=your_client_id \
-e MARKETO_CLIENT_SECRET=your_client_secret \
-e MARKETO_BASE_URL=https://xxx-xxx-xxx.mktorest.com
```
### Cursor
Add to `.cursor/mcp.json` in your project root (or `~/.cursor/mcp.json` globally):
```json
{
"mcpServers": {
"marketo": {
"command": "npx",
"args": ["marketo-mcp-server"],
"env": {
"MARKETO_CLIENT_ID": "your_client_id",
"MARKETO_CLIENT_SECRET": "your_client_secret",
"MARKETO_BASE_URL": "https://xxx-xxx-xxx.mktorest.com"
}
}
}
}
```
### Docker
```bash
docker build -t marketo-mcp-server .
docker run -e MARKETO_CLIENT_ID=... -e MARKETO_CLIENT_SECRET=... -e MARKETO_BASE_URL=... marketo-mcp-server
```
---
## Tools reference
### Leads (6 tools)
| Tool | Description |
|---|---|
| `marketo_get_lead_by_id` | Get a single lead by Marketo lead ID |
| `marketo_get_lead_by_email` | Look up a lead by email address |
| `marketo_create_or_update_leads` | Batch upsert up to 300 leads |
| `marketo_delete_lead` | Permanently delete a lead by ID |
| `marketo_get_activities_paging_token` | Get an initial paging token required by the activities endpoint |
| `marketo_get_lead_activities` | Get activity log for a lead (requires paging token, filterable by activity type) |
### Programs (5 tools)
| Tool | Description |
|---|---|
| `marketo_get_programs` | List programs with pagination and type/date filtering |
| `marketo_get_program_by_id` | Get full program metadata by ID |
| `marketo_clone_program` | Clone a program with all local assets into a target folder |
| `marketo_clone_program_with_tokens` | Clone a program and immediately update its my.tokens in one shot |
| `marketo_get_program_members` | Get leads enrolled in a program |
### Emails (4 tools)
| Tool | Description |
|---|---|
| `marketo_get_emails` | List email assets with status filtering |
| `marketo_get_email_by_id` | Get full email metadata including HTML and module structure |
| `marketo_clone_email` | Clone an email asset to a target folder |
| `marketo_send_sample` | Send a test/sample email, optionally rendered with a lead's tokens |
### Forms (4 tools)
| Tool | Description |
|---|---|
| `marketo_get_forms` | List forms with pagination and status filtering |
| `marketo_get_form_by_id` | Get form metadata including fields and visibility rules |
| `marketo_clone_form` | Clone a form to a target folder |
| `marketo_approve_form` | Approve a form draft to make it live |
### Smart Lists (2 tools)
| Tool | Description |
|---|---|
| `marketo_get_smart_lists` | List smart lists with pagination |
| `marketo_get_smart_list_by_id` | Get a smart list with its full filter definitions |
| `marketo_search_campaigns_by_filter` | Find all smart campaigns whose smart list uses a specific filter or trigger type |
### Static Lists (3 tools)
| Tool | Description |
|---|---|
| `marketo_get_lead_lists` | Get leads that are members of a static list |
| `marketo_add_leads_to_list` | Add up to 300 leads to a static list |
| `marketo_remove_leads_from_list` | Remove up to 300 leads from a static list |
### Channels (3 tools)
| Tool | Description |
|---|---|
| `marketo_get_channels` | List all channels and their progression statuses |
| `marketo_get_channel_by_id` | Get a single channel by ID |
| `marketo_create_channel` | Create a channel with custom progression statuses |
### Landing Pages (3 tools)
| Tool | Description |
|---|---|
| `marketo_get_landing_pages` | List landing pages with status filtering |
| `marketo_get_landing_page_by_id` | Get full LP metadata including template and form embeds |
| `marketo_clone_landing_page` | Clone a landing page to a target folder |
### Bulk Export (4 tools)
| Tool | Description |
|---|---|
| `marketo_create_bulk_export_leads` | Create a bulk lead export job with field list and date filter |
| `marketo_enqueue_bulk_export` | Enqueue a created export job for processing |
| `marketo_get_bulk_export_status` | Poll the status of a running export job |
| `marketo_get_bulk_export_file` | Download the file from a completed export job |
### Admin (4 tools)
| Tool | Description |
|---|---|
| `marketo_describe_lead_fields` | List all 850+ lead fields with API names, display names, data types — filterable by name or type |
| `marketo_list_activity_types` | List all activity types with IDs and attributes — reference for building activity queries |
| `marketo_change_program_status` | Change program membership status for up to 300 leads (e.g. mark as Attended, No Show) |
| `marketo_browse_folders` | Browse the Marketing Activities folder tree to find destination folder IDs |
### Analytics (3 tools)
| Tool | Description |
|---|---|
| `marketo_get_lead_timeline` | Reconstruct the full chronological story of a lead — form fills, email opens/clicks, score changes, SFDC pushes, and program status changes |
| `marketo_clone_program_with_tokens` | Clone a program and immediately update its my.tokens (text, date, href, richText, score) in a single operation |
| `marketo_rank_campaign_engagement` | Rank campaigns by email opens, clicks, form fills, and unsubscribes for a date range using the activities API |
| `marketo_get_engagement_program_health` | List all nurture programs with status, days since last update, and stale flags |
| `marketo_get_smart_campaign_map` | For a program, return all smart campaigns with their trigger and filter rules |
| `marketo_find_dead_programs` | Find active programs not updated in N days — candidates for archiving |
---
## Authentication
Marketo uses OAuth 2.0 client credentials. The server obtains and caches a token automatically, refreshing it 60 seconds before expiry. No manual token management required.
---
## License
MIT — see [LICENSE](LICENSE).
