Generate Invoices with OpenAI Codex

Add pmnt to OpenAI Codex with one command in Codex CLI. The IDE extension and the ChatGPT desktop app use the same server entry. Ask Codex for an invoice in plain words. Codex returns a payment link with an NBU QR code.

MCP Server URL

https://mcp.pmnt.app

You need this URL only when you add the server by hand. Enter it exactly as shown, with no slash at the end.

IBAN payments with QR in OpenAI Codex

Works in
Codex CLI, the Codex IDE extension and Codex in the ChatGPT desktop app
Setup
One MCP server entry, or the pmnt plugin for Codex CLI
Sign-in
Your pmnt account, in the browser. One permission: create invoices.
Tools
create_invoice creates an invoice in your pmnt account. list_payees shows your businesses and bank accounts. list_payment_categories shows the payment categories.
You need
An active pmnt trial or subscription and a business with a bank account.

Requirements

You need a pmnt account with an active trial or subscription. Add at least one business with a bank account at app.pmnt.app. The 15-day free trial starts when you first sign in at app.pmnt.app.

Codex: sign in with your ChatGPT account or with an OpenAI API key. The Codex pricing page lists MCP for the Plus, Pro, Business, Enterprise and Edu plans and for API keys.

OpenAI documentation: MCP in Codex

Create a pmnt account

Set up pmnt in Codex

Codex CLI, the IDE extension and the ChatGPT desktop app share the MCP servers in ~/.codex/config.toml. Add the pmnt server once, and all three can use it. The IDE extension does not support plugins. Use one way only.

Add the pmnt MCP server in Codex CLI (recommended)

  1. Run this command. Codex adds the server to ~/.codex/config.toml and opens the pmnt sign-in page:

    codex mcp add pmnt --url https://mcp.pmnt.app

    Expected output 

    Added global MCP server 'pmnt'.
Detected OAuth support. Starting OAuth flow…

  3. In a Codex session, type /mcp. The list shows pmnt and its tools.

The command writes this entry. You can also add the entry to ~/.codex/config.toml by hand and then run codex mcp login pmnt: 

[mcp_servers.pmnt]
url = "https://mcp.pmnt.app"

Add pmnt to Codex in the ChatGPT desktop app

These steps add pmnt to Codex. To use pmnt in ChatGPT chats, see the ChatGPT page.

  1. Open the ChatGPT desktop app and select Codex. Open Settings (Cmd+, on macOS, Ctrl+, on Windows) and select MCP servers.

  2. Select Add server. Enter pmnt as the name, choose Streamable HTTP and enter https://mcp.pmnt.app.

  3. Save the server, then select Restart.

  4. The list shows that pmnt needs a sign-in. Select Authenticate.

  6. In the composer, type /mcp to see the connected servers.

Add pmnt in the Codex IDE extension

  1. Open Codex in VS Code, Cursor or Windsurf. If you do not see the Codex icon, run Codex: Open Codex Sidebar from the Command Palette.

  2. Open the gear menu and select MCP servers.

  3. Select Add server. Enter pmnt as the name, choose Streamable HTTP and enter https://mcp.pmnt.app.

  4. Save the server, then select Restart extension.

  5. When pmnt needs a sign-in, select Authenticate.

The IDE extension does not support plugins. Use these steps or the codex mcp add command.

Install the pmnt plugin in Codex CLI

  1. Add the pmnt marketplace:

    codex plugin marketplace add pmnt-app/agent-plugins

  2. Install the plugin:

    codex plugin add pmnt@pmnt-app

    Codex adds one MCP server with the name invoices. The plugin does not sign you in, so codex mcp list shows Not logged in:

    Expected output 

    Name      Url                   Bearer Token Env Var  Status   Auth
invoices  https://mcp.pmnt.app  -                     enabled  Not logged in

  3. Sign in to pmnt:

    codex mcp login invoices

  5. Start a new Codex session. Codex loads the plugin tools when a session starts.

Check the connection

Send this request to Codex:

Show my pmnt businesses and bank accounts

Codex calls list_payees and shows the businesses and bank accounts from your pmnt account. If it asks you to sign in, see Troubleshooting.

In a terminal, run codex mcp list. If the Auth column shows Not logged in, run codex mcp login pmnt, or codex mcp login invoices for the plugin.

Create your first invoice

Ask for an invoice in plain words. For example:

Create a pmnt invoice for 500 UAH for consulting services, valid for 7 days

Create a pmnt invoice for a donation to the school fund. Let the payer enter the amount

The answer has a payment link (app.pmnt.app/pay/...). The payment page shows the invoice and an NBU-standard QR code. Send the link to your customer. The customer scans the QR code with a banking app and pays by bank transfer.

If Codex asks you to approve the pmnt tool, check the amount and the purpose first.

Questions

Do the CLI and the IDE share setup?

They share the MCP servers in ~/.codex/config.toml. A server that you add in one of them is also in the others. The IDE extension does not support plugins. If one of them asks you to sign in, sign in there too.

Can Codex ask before each invoice?

Yes. Add default_tools_approval_mode = "writes" to the [mcp_servers.pmnt] table in ~/.codex/config.toml. Then Codex asks before it runs tools that are not read-only, such as create_invoice.

Does the assistant get my password?

No. You sign in on the pmnt sign-in page, not in the chat. Codex gets one permission, Create invoices. With it, the assistant can create invoices and read your businesses, bank accounts and payment categories in pmnt. You can cancel this access at any time.

Do I type my IBAN in the chat?

No. pmnt takes the business and the IBAN from your pmnt account. The tool result contains the business name, the IBAN and the payment link, so Codex sees them.

How do I disconnect pmnt?

Run codex mcp logout pmnt to sign out, or codex mcp remove pmnt to delete the server. For the plugin, run codex plugin remove pmnt@pmnt-app.

Troubleshooting

The browser does not open
On SSH or a remote machine, run codex mcp login pmnt --no-browser, or codex mcp login invoices --no-browser for the plugin. Open the URL that Codex shows and sign in. If the last page does not load, copy the full URL from the address bar and paste it into the terminal.

You see both invoices and pmnt
You installed the plugin and added the server. Keep one: run codex mcp remove pmnt, or run codex plugin remove pmnt@pmnt-app.

The pmnt tools do not show
Start a new session. In the ChatGPT desktop app, select Restart. In the IDE extension, select Restart extension.

Codex CLI has no plugin command
Update Codex CLI. We checked the plugin commands with version 0.167.0.

Messages from the pmnt tools

When a pmnt tool fails, Codex gets one of these messages. The assistant can show the message in other words.

Sign-in is required. Connect your pmnt account, then try again.
Run codex mcp login pmnt, or codex mcp login invoices for the plugin. In the app or the IDE extension, select Authenticate in the list of MCP servers.
No pmnt account is linked to this sign-in. Create an account or sign in at https://app.pmnt.app, then try again.
Sign in at app.pmnt.app with the same account, or create an account there. Then try again.
Your pmnt subscription or trial is not active, so invoices cannot be created from this assistant. Plan information: https://pmnt.app/pricing
Renew the subscription at app.pmnt.app. The 15-day free trial starts when you first sign in at app.pmnt.app. See plans and prices
Your pmnt account has no business with a bank account. Add one at https://app.pmnt.app, then try again.
Add a business and its bank account at app.pmnt.app. Then try again.
Too many invoices in a short time. Wait a minute and try again.
Wait one minute, then try again.
The pmnt service is not available now. Try again later.
Try again in a few minutes. If you see the message again, write to support@pmnt.app.

Privacy and security

  • To create an invoice, pmnt uses your pmnt user ID, the business and bank account of the invoice, the purpose and the amount.
  • The MCP server does not collect your chat history, your location, payment card data or your password. It does not store your sign-in token.
  • The invoice goes to your pmnt account at app.pmnt.app. Your AI assistant provider (for example Anthropic, OpenAI, Perplexity, Google or GitHub) gets the tool result. Its own privacy policy covers your chat.
  • Invoices stay in your pmnt account until you delete them.

For privacy-related questions or data deletion requests, contact us at: support+legal@pmnt.app

Read the full MCP Privacy Policy Read the MCP Terms of Service

Use pmnt with other AI assistants