Codex logo

Document processing in Codex

Add Parseur's MCP server to Codex to create mailboxes, upload documents from your project and read the extracted data. The Codex CLI, IDE extension and app share the same setup.

Step 1

Connect the MCP server

  1. 1 Run the first command to add Parseur.
  2. 2 Run the second command, then sign in to Parseur in your browser and approve access.
Terminal
codex mcp add parseur --url https://api.parseur.com/mcp
codex mcp login parseur
Step 2

Get files to the agent

Ask Codex to process a file in your project. It creates an upload link, uploads the file to the right Parseur mailbox itself, then reads the extracted data.

  • Each upload link works for one upload, which can hold several files, and expires after 60 minutes by default.
  • Files at a public URL, and email text pasted into the chat, need no upload link.
  • Every Parseur mailbox has its own email address, so you can also forward documents to it.

Try these prompts

Paste one into the chat and let the agent pick the tools.

Upload the PDFs in ./invoices to my Parseur invoices mailbox and wait until they are processed.
Download my Parseur invoices mailbox as CSV and write a script that imports it into our database.
Show me why my last Parseur document failed, then reprocess it.

Check it works

The agent lists your Parseur mailboxes. No credits are used.

List my Parseur mailboxes.
Get started

Ready to automate your
document data extraction?

Start free in minutes and see how Parseur fits into your workflow.

No model training required
Automates data entry from any document
Scales from point-and-click to API

Frequently Asked Questions

Run codex mcp add parseur --url https://api.parseur.com/mcp, then codex mcp login parseur and sign in to Parseur in your browser. The Codex CLI, IDE extension and app read the same configuration.

Yes. Codex creates an upload link and uploads the file itself, then reads the extracted data. Each link works for one upload and expires after 60 minutes by default. Files at a public URL need no upload link.

No. Documents sent from Codex use the same page credits as documents sent any other way. The free plan includes 20 pages a month. See Parseur pricing.

The connection expired or was revoked. Run codex mcp login parseur and sign in to Parseur again.

Codex only sees the tools your Parseur role allows. For example, a role that cannot delete mailboxes hides the delete tools. An account admin can change your role in Parseur.