Codex + Monthly

Write social media posts from Codex

Bring your Monthly accounts, publishing formats and post status into Codex. One connection. Only the access you choose.

Codex Monthly
Example conversation
You

Which of my connected accounts are ready for my next post?

Checked in Monthly

Your selected X account is ready.

Make the connection

Connect Codex to Monthly.

Connect your social accounts in Monthly first. Then add Monthly to the agent you already use.

01

Add Monthly in your terminal

Run the commands below. If Monthly is already configured, inspect that entry first so you do not create a duplicate.

MCP server URL
https://app.monthly.so/mcp
Codex CLI
codex mcp add monthly --url https://app.monthly.so/mcp
codex mcp login monthly --scopes accounts:read,posts:read --oauth-client-registration dcr
02

Sign in. Choose what to share.

Use your own Monthly account. Keep accounts:read and posts:read selected; leave drafting/media and scheduling/cancellation off. Select only your intended accounts.

03

Check your connection

Ask Codex to list the accounts this Monthly connection can access. The result should match your selection. No post needs to be created or published.

No API token or shared client secret is needed for this OAuth flow.

Detailed setup & compatibility notes

Use your installed Codex CLI and your existing Monthly account. OAuth opens Monthly in your browser; no API token or shared client secret is needed.

MCP server URL
https://app.monthly.so/mcp
Codex CLI
codex mcp add monthly --url https://app.monthly.so/mcp
codex mcp login monthly --scopes accounts:read,posts:read --oauth-client-registration dcr
  1. 01

    Add the server once

    Run the commands above. If monthly already exists, inspect it with codex mcp get monthly instead of adding a duplicate. The login command pins this connection to the two read permissions.

  2. 02

    Keep the connection read-only

    Sign in to your own Monthly account. On the consent page, keep the two read permissions selected and choose only your own accounts that you intend to share. Allow selected access, then return to the terminal. You do not need access to Monthly’s test account.

  3. 03

    Save the read-only defaults

    In ~/.codex/config.toml, merge the fields below into the existing monthly entry. Preserve other servers. The tool allowlist adds a client-side limit; Monthly enforces the OAuth scope and selected accounts.

  4. 04

    Verify in Codex

    Start a fresh Codex session and inspect /mcp. Send the read-only check below. The result must show only your selected account. No draft, upload or schedule is part of this setup.

Codex config.toml
[mcp_servers.monthly]
url = "https://app.monthly.so/mcp"
scopes = ["accounts:read", "posts:read"]
enabled_tools = ["get_profile", "get_capabilities", "list_accounts", "list_posts", "get_post"]

Leave the advanced OAuth resource override unset so Codex uses Monthly’s discovery. If using --no-browser, paste the complete return URL only into your own waiting Codex terminal, never into a conversation or configuration file.

Client instructions checked October 26, 2026. Codex MCP documentation. Production Codex OAuth and four direct read-tool checks passed on October 26 through the installed client, with only @TryMonthly and accounts:read/posts:read. No model turn or write tool was used. Drafting, scheduling and client revocation/reconnection remain unverified.

A conversation starter

Things you can ask Codex

Copy a prompt after connecting Monthly, or open it in Codex with one click — automatically typed in, waiting for you to press Enter. Opens the desktop app. Install it and connect Monthly there first; your browser may ask you to confirm opening it.

Your accounts, at a glance.

See exactly which accounts this connection can access.

Use Monthly to show the social accounts I’ve allowed this connection to access and which are ready to publish. Read only; don’t create or schedule anything.
Open in Codex

Spot a connection issue.

Know what needs reconnecting before you begin.

Check my selected Monthly accounts for connection issues. Tell me which need reconnecting and what to do next. Don’t change anything.
Open in Codex

Know what fits.

Check text lengths, image limits and supported formats.

Which formats can my selected Monthly accounts use? Show text lengths, image limits and file sizes. Read only; don’t upload or create anything.
Open in Codex

Find your review links.

Bring connection-created drafts back into view.

Show drafts created by this Monthly connection with their review links and approval status. Don’t edit, approve or schedule anything.
Open in Codex

Follow a post’s progress.

Read actual delivery status, without guessing.

Did posts created by this Monthly connection publish? Show their observed status and any delivery receipt IDs. Don’t retry or cancel anything.
Open in Codex

Check your permissions.

Keep the agent’s access easy to understand.

What is this Monthly connection allowed to do, and which accounts can it access? Read only; don’t request or change any permissions.
Open in Codex
CHANNEL YOUR THOUGHTS

Accounts Codex can post to.

Post to the social accounts you’ve connected in Monthly.

A few good questions

Good to know before you connect.

Do I need a Monthly account?

Yes. Connect your social accounts in Monthly, then sign in to your own Monthly account during your agent’s OAuth flow. Each customer gets their own scoped connection; you never use another customer’s login or social credentials.

What can my agent see?

Only the accounts you select during consent and the permissions you allow. Post reads are limited to posts created by that same connection. Your social access tokens and passwords stay in Monthly.

Can it publish without my approval?

The read-only setup on this page cannot create or schedule posts. If you later grant drafting and scheduling permissions, every exact draft revision still needs your approval inside Monthly before it can be scheduled. Editing a draft clears its approval.

Do I need an API key?

Compatible MCP clients use OAuth sign-in and automatic client registration. You do not need to copy a Monthly API token or a shared client secret. Your agent’s account or subscription requirements are separate.

Why does the agent need me to sign in again?

A client may need to renew authorization or reconnect an expired account. Use the normal sign-in flow and check the permissions again. Never disable authentication or share a social password with an agent.

How do I disconnect an agent?

Open Monthly Settings → AI agents & API and revoke that connection. Revocation stops further agent actions. It does not cancel posts already in your queue; review those separately.

Your next step

Your agent.
Your accounts. Your call.

Get started in minutes.

Try Monthly