# AI Agents

> Connect Mailrith to ChatGPT, Codex, Claude, and other AI clients with OAuth, MCP, and scoped tools for safe email marketing workflows.

- Human page: https://mailrith.com/features/ai-agents
- Markdown page: https://mailrith.com/features/ai-agents.md
- Feature category: Keep Brands And Teams Organized
- Primary keyword: ChatGPT and Codex email marketing plugin
- Related keywords: AI Agent email marketing platform, AI Agent email marketing, Mailrith ChatGPT plugin, Mailrith Codex plugin, Mailrith Claude Connector, Claude email marketing connector, MCP email marketing platform, email marketing for AI agents, safe AI email automation
- Last reviewed: 2026-08-25

## Direct Answer
Use Mailrith from ChatGPT, Codex, Claude, or another supported AI client. Connect one workspace, choose a focused task, and begin with controlled access. Global rollout controls may pause protected operations while Mailrith validates the complete workflow.

- Install the Mailrith plugin from Plugins in ChatGPT or Codex, or connect the Mailrith Connector from Claude's Connectors Directory.
- Use OAuth for other supported clients, or keep a task-specific API key in a trusted server-side secret manager.
- Start read-only, add only the Permissions the task needs, and verify every change from the current Mailrith resource.

## What This Feature Helps You Do
- **Reporting And Research:** Let a read-only agent inspect workspace capabilities, Subscribers, campaigns, and progress without granting write or send access.
- **Drafting And Synchronization:** Create Broadcast drafts or synchronize Subscriber data with typed inputs, bounded pagination, request IDs, and idempotency safeguards.
- **Scoped Operations:** Grant only the resource Permissions and Work Profile that the workflow needs.

## When To Use This Feature
- Use AI Agents when another application or agent runtime needs to inspect or operate Mailrith on a user's behalf.
- Use AI Agents when you need repeatable email marketing work across reporting, Subscriber sync, drafting, execution, and progress checks.
- Use a dedicated workspace with no real Subscribers when first testing a workflow with writes or external effects.

## When This May Not Be The First Thing To Set Up
- Use AI Writing instead when you only want help writing copy inside a Mailrith editor.
- Do not connect an agent before you can describe its task and choose the smallest matching Work Profile.
- Do not use a live workspace for early workflow experiments.

## A Simple Setup Path
1. Choose one focused task and begin with read-only access.
2. Install Mailrith from Plugins in ChatGPT or Codex, or use /plugins in Codex CLI. After installation, start a new ChatGPT chat or Codex session. The Codex IDE extension does not support plugins.
3. For Claude, open Customize, choose Connectors, select the + button, browse connectors, choose Mailrith, and select Connect.
4. For either directory connection, sign in to Mailrith, choose one workspace, review the requested permissions, and select Allow Access.
5. For another supported client, connect to Mailrith's remote MCP server through OAuth. Use a task-specific API key only in a trusted server-side runtime that stores the key in a secret manager.
6. Run capability discovery and expose only the tools required for that task.
7. Test the workflow in a dedicated workspace with no real Subscribers, then inspect every request ID and result.
8. For mutating work, grant only the required Permission, run any documented preflight check, and read the changed resource or progress endpoint to confirm the result.

## Common Mistakes To Avoid
- **Granting Broad Access First:** Begin with read-only tools and expand the connection only when a tested workflow has a clear need for another permission.
- **Granting One Credential Too Much:** Use separate task-specific credentials so a reporting workflow does not also receive resource write access or Full Email Marketing Access.
- **Retrying An Uncertain Result:** Use the request ID to inspect the current resource or progress state. Do not repeat a mutation until you know whether the first attempt changed anything.

## How This Connects With The Rest Of Mailrith
- Subscribers, tags, and custom fields support reporting and synchronization tasks.
- Broadcasts, sequences, and automations support draft-first campaign workflows.
- Request IDs and progress endpoints help reconcile uncertain results.
- Email delivery connections and preflight checks remain the only path to provider delivery.

## Keep Exploring
- [AI Agent Client Compatibility](https://mailrith.com/developers/agent-compatibility.md): Install Mailrith in ChatGPT or Codex, connect it in Claude, compare other supported clients, and follow the current safety guidance.
- [AI Writing](https://mailrith.com/features/ai-writing.md): Mailrith AI Writing helps draft broadcasts, sequence emails, sequence plans, and automation ideas. Review each draft before anything goes live.
- [Broadcasts](https://mailrith.com/features/broadcasts.md): Mailrith Broadcasts help you write, select subscribers, test, schedule, send, and review one-time emails.
- [Automations](https://mailrith.com/features/automations.md): Mailrith Automations help you build subscriber follow-up with triggers, waits, rules, emails, tags, and sequences.

## Related Email Sending Setup Pages
- [Amazon SES Email Marketing](https://mailrith.com/features/amazon-ses-email-marketing.md): Use Mailrith with Amazon SES for email marketing campaigns, newsletters, forms, automations, and reports while Amazon SES handles delivery.
- [Postmark Email Marketing](https://mailrith.com/features/postmark-email-marketing.md): Postmark Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while Postmark handles delivery.
- [SendGrid Email Marketing](https://mailrith.com/features/sendgrid-email-marketing.md): SendGrid Email Marketing with Mailrith: run campaigns, newsletters, forms, automations, and reports while SendGrid handles delivery.
