Zoho Campaign MCP Server

Zoho Campaign

Zoho Campaign is an email marketing platform for creating, sending, scheduling, and analyzing email campaigns. Manage mailing lists, track subscriber engagement, and measure campaign performance.

Data Model

• Mailing Lists — subscriber groups that campaigns are sent to. Each list has a unique listkey. Get listkey from the list-mailing-lists tool.
• Subscribers — contacts subscribed to mailing lists. Manage via subscribe/unsubscribe tools with the listkey.
• Campaigns — email campaigns (draft, scheduled, or sent). Each has a unique campaignkey. Get campaignkey from list-recent-campaigns.
• Tags — labels for organizing campaigns and contacts.
• Topics — content categories for campaign classification.

Workflow Patterns

1. Create and send a campaign: create mailing list → subscribe contacts → create campaign with list_details mapping → send or schedule the campaign.
2. View campaign performance: list recent campaigns → get campaignkey → get campaign reports (opens, clicks, bounces).
3. Manage subscribers: list mailing lists → get listkey → list subscribers or get subscriber count.
4. Add a subscriber: list mailing lists → get listkey → subscribe contact with email + name fields.
5. Remove a subscriber: list mailing lists → get listkey → unsubscribe contact with email.
6. Schedule a campaign: create campaign → schedule with date, hour, minute, and AM/PM.
7. Clean up: delete campaigns or mailing lists that are no longer needed.
8. Rename or adjust drafts: update campaign (subject, sender, HTML, etc.) by campaignkey; rename a list with listkey and a new listname.

Important Constraints

• listkey is required: Subscriber operations (list, count, subscribe, unsubscribe) all need the listkey from the mailing lists listing.
• campaignkey is required: Campaign detail/report/recipient/send/schedule/delete tools need the campaignkey from recent campaigns.
• list_details for campaign creation: Must be a JSON-encoded string mapping listkeys to segmentkeys, e.g. {"listkey1":"segmentkey1"}.
• contactinfo format: Subscribe/unsubscribe expect a JSON-encoded string like {"Contact Email":"user@example.com","First Name":"John"}.
• Confirmation emails: Subscribing a contact sends a confirmation email — the contact must confirm before appearing as subscribed.
• Scheduling format: scheduledate is mm/dd/yyyy, schedulehour is 1-12, am_pm is AM or PM.
• API returns JSON: All tools automatically request JSON format from the Zoho Campaign API.
• Deletions are permanent: Deleting a campaign or mailing list cannot be undone.