# SimpleNewsletter365

> SimpleNewsletter365 is a Microsoft 365-native newsletter tool for business subscriptions. It sends newsletters from your own Microsoft 365 mailbox over Microsoft Graph, using your real address and domain, with no shared sending pool. Personal Microsoft accounts are not supported. Contacts are unlimited on every plan; you are billed on emails sent, not on list size.

## What it does

- Sends newsletters from your own Microsoft 365 mailbox (Microsoft Graph), not a shared marketing IP, for deliverability that matches your everyday email.
- Unlimited contacts on every plan, including Free. Billing is metered on emails sent per month.
- Contacts and segments, hosted signup forms with double opt-in and bot protection.
- Optional custom domains for branded tracking links and click analytics.
- Delivery, bounce, and unsubscribe reporting for every send.
- Team roles and permissions, with shared mailbox or alias sending.
- An authenticated MCP server with full parity to the web app: 106 tools across newsletter drafting, reporting, audience management, send operations, and organization admin, always within the signed-in user's permissions.

## For AI agents (MCP)

SimpleNewsletter365 exposes an authenticated Model Context Protocol server. Codex connects over OAuth 2.1 Authorization Code with PKCE and an explicit human consent step. Once connected, the agent acts as the authorizing user and stays within the user's account memberships, permissions, organization policy, and personal client grant.

All five bundles are grantable and cover the full web-app surface:

- Newsletter drafting: list, read, create, rename, update, validate, preview, render full screenshots, and test draft newsletters.
- Reporting: delivery summaries, click engagement, recipient metrics, short-link events, recipient lists, and as-sent rendered output. Full recipient identity still requires ManageContacts.
- Audience management: contacts (create, update, batch, import from CSV, OneDrive CSV, Outlook, or Microsoft Bookings), segments (including restore), signup forms, custom field labels, double opt-in subscriptions, unsubscribe tokens, and subscriber history.
- Send operations: mailbox readiness, audience selection, and send start, pause, resume, and stop, each real send gated by human confirmation.
- Organization admin: organization settings, team invitations and member permissions, custom domains, short links, plan management, and MCP policy and grants.

Start every session by calling accounts_list with no arguments: it returns the accounts you belong to with their ids and your permission set, and every other tool takes one of those accountIds. If the list is empty, onboard entirely over MCP: call legal_accept (the human must have agreed to the terms), then account_create with a display name; the signed-in user becomes the Owner and the returned accountId works with every other tool immediately. Destructive or security-sensitive actions create a pending confirmation the human approves in the web app (Settings > MCP) or, for standard actions, with a one-time code; access-changing actions always require web approval. Billing checkout, the billing portal, and mailbox consent are returned as short-lived handoff URLs the human opens in their browser; treat those URLs as secrets and do not store them.

Newsletter draft tools return `editorUrl`, and preview tools return `reviewUrl`. These are authoritative authenticated browser deep links built by the server. Return them verbatim when the human wants to open or review the newsletter. Never guess or assemble an application route from an account, campaign, or snapshot id. These links are not bearer URLs: opening one still requires the human's existing SimpleNewsletter365 browser session and normal account permissions.

Use `newsletter_render_screenshots` when the human asks you to inspect or debug visual newsletter rendering. It renders the same newsletter snapshot and preview component used by the web app, then returns four complete PNG images: desktop light, desktop dark, mobile light, and mobile dark. Each image includes only the full newsletter content, not the preview label, From, Subject, Preheader, or visible editor viewport. Desktop images use Urlbox's high-resolution @2x retina rendering. Analyze the returned images directly for overflow, clipping, contrast, spacing, and responsive-layout problems. When the human asks to see the screenshots, forward all four image blocks into the user-facing response as attachments with their variant labels. If the client cannot surface MCP image blocks, say so and provide a download fallback by saving each PNG as an ordinary file when artifact or file support is available. The temporary capture URL is private implementation detail and is never returned by the tool.

Codex setup:

1. Use Codex's default ephemeral OAuth callback port. Do not add `mcp_oauth_callback_port` to the user's config or require a preliminary restart.
2. Run `codex mcp remove simplenewsletter365` if an older entry exists.
3. Run `codex mcp add simplenewsletter365 --url https://app.simplenewsletter365.com/mcp --oauth-client-id simplenewsletter365-mcp-public --oauth-resource https://app.simplenewsletter365.com/mcp`.
4. Run `codex mcp login simplenewsletter365 --scopes mcp,offline_access`.
5. The human completes Microsoft sign-in and approves the SimpleNewsletter365 consent screen.
6. After OAuth succeeds, stop using browser or computer automation for SimpleNewsletter365. Use the MCP tools for every supported operation.
7. If an operation is not exposed or granted through MCP, state that limitation. Do not silently fall back to navigating or clicking the web app.

SimpleNewsletter365 uses a curated public OAuth client and does not expose Dynamic Client Registration. MCP is enabled by default for new organizations. The organization policy does not need a separate enable action before OAuth discovery or login. An organization owner can explicitly disable MCP or narrow allowed bundles under Settings > MCP. Each member can review or revoke their own client grant there. Microsoft 365 and mailbox tokens remain server-side and are never placed on the MCP token. Details and recovery steps: https://www.simplenewsletter365.com/help/automate-with-mcp

## Who it is for

Businesses, teams, and individuals with a Microsoft 365 business subscription who want newsletters that send from their own mailbox and domain instead of a shared marketing IP.

## Pricing

Send-metered, with unlimited contacts on every plan. Free includes 10,000 sends per month. Paid plans (billed monthly or annually) add custom domains, click analytics, team seats, and higher send allowances. Full structured pricing: https://www.simplenewsletter365.com/pricing.md

## Key pages

- Homepage: https://www.simplenewsletter365.com/
- Features: https://www.simplenewsletter365.com/features
- AI agents and MCP: https://www.simplenewsletter365.com/ai
- Pricing: https://www.simplenewsletter365.com/pricing
- Security: https://www.simplenewsletter365.com/security
- Help center: https://www.simplenewsletter365.com/help
- Blog: https://www.simplenewsletter365.com/blog
- Machine-readable pricing: https://www.simplenewsletter365.com/pricing.md