Codex + Hashnode

Post to Hashnode from Codex

Connect Codex to PostDelegate once, then ask it for Hashnode posts from the Codex CLI or IDE extension. Ask for a draft and it waits on your calendar until you schedule it.

Codex drafts it. You approve it. PostDelegate posts it.Hashnode: Markdown articles to one of your publications.

How to post to Hashnode from Codex

  1. Add PostDelegate to Codex. Add the server to ~/.codex/config.toml as below. Run codex mcp login postdelegate and sign in in your browser.

    ~/.codex/config.toml

    [mcp_servers.postdelegate]
    url = "https://app.postdelegate.com/mcp-oauth-dynamic"
  2. Connect Hashnode in PostDelegate. In your Hashnode account's developer settings, generate a personal access token. Hashnode calls it that and PostDelegate calls it the API key. Hashnode owns that screen, so its wording may change.
  3. Ask Codex for a draft. Describe the post in plain words. Codex checks your Hashnode channel's rules, creates the post and sends back a preview link.

Teach Codex the posting rules

Add PostDelegate’s AGENTS.md to your repository, so Codex knows the MCP tools, the REST API and the safety rules when it works there. Agent files has the steps.

What to ask Codex

Mention any Hashnode setting in plain words and Codex fills it in. Codex can also read text files in your project, such as a changelog or a draft in Markdown.

  • Draft a Hashnode article for my publication with a title, subtitle and the tags javascript and testing.
  • Schedule the article for Wednesday at 11:00 with a canonical URL to our blog.
  • Turn docs/architecture.md into a Hashnode article with a cover image from my media library, as a draft.

What Codex can do on your Hashnode channel

  • Check the rules first. Before writing, it reads your Hashnode channel's length limit (10,000 characters) and required settings.
  • Draft, schedule or post. It creates a draft, a scheduled post or an immediate post, and runs the same checks as the app.
  • Use your media. It attaches files from your media library or adds one from a public link.
  • Review and fix. It lists what is scheduled, changes the Hashnode settings of a post that has not gone out, and deletes posts you no longer want.

A Hashnode article always belongs to a publication, so PostDelegate loads the publications on your account and asks you to choose one. It also asks for at least one tag from Hashnode's tag list, because Hashnode requires it. The title needs at least six characters, and the subtitle and cover image are optional.

Hashnode settings Codex can fill in

SettingNotes
TitleRequired, at least 6 characters.
SubtitleOptional, at least 2 characters.
Cover imageOptional.
Canonical URLOptional. Use it when the article first appeared elsewhere.
PublicationRequired. Choose from the publications on your account.
TagsRequired, at least one, picked from Hashnode's tag list.

Before you start

  • The account needs at least one publication. If none is listed, create one on Hashnode first.
  • The article body is limited to 10,000 characters.

The Hashnode channel guide has every field, and MCP tools lists exactly what an assistant can and cannot do.

Questions

Will Codex publish to Hashnode without asking me?
Not unless you ask it to. Ask for a draft and the post waits on your calendar until you schedule it, and your workspace's approvals apply as usual. Tools that change data are marked as such, so Codex can ask you before it schedules or deletes anything.
Do I need an API key to connect Codex?
No. Codex signs in with your PostDelegate account through your browser. An API key is only for clients that cannot sign in, as described in MCP clients.
Does it cost extra to use Codex with PostDelegate?
No. The MCP server is on every plan, and Codex runs on your own Codex account, so PostDelegate never charges for AI. Every plan starts with a 7-day free trial with no card.
Can Codex attach images or video to a Hashnode post?
It can use files already in your media library, or add one from a public link. It cannot fetch files from your computer, so upload those in the app first. See MCP tools.
Do I need a Hashnode publication to schedule an article?
Yes. Publication is a required setting, and the list comes from the publications on your Hashnode account. If the list is empty, create a publication on Hashnode first, then reopen the post.
Can I set a canonical URL on a Hashnode article?
Yes. Canonical URL is an optional setting. Use it when the article first appeared on another site.

Hashnode from other assistants

Other networks from Codex

Prefer to plan Hashnode posts yourself? See the Hashnode scheduler.

Try it for 7 days

Your next great post starts here.

Give your ideas a home. Plan your content, find your rhythm, and bring your social channels together.

Start your 7-day free trial

No credit card required

Add a card before the trial ends to keep your plan.