# Connect Codex to PineBill

> Add PineBill to Codex with one command and manage time, tasks and invoices from the CLI.

Codex is OpenAI's coding agent for the terminal. PineBill's MCP server lets Codex work with your PineBill invoices, estimates, customers, products, expenses, projects, tasks, timers, calendar and reports.

Server URL: https://www.pinebill.app/api/mcp (remote MCP over Streamable HTTP, OAuth 2.1 sign-in, no API key).

## Setup

1. Run the command below in your terminal.
2. Codex detects that PineBill uses OAuth and opens your browser.
3. Sign in to PineBill, choose your access and click Allow access.

Terminal:

```
codex mcp add pinebill --url https://www.pinebill.app/api/mcp
```

## Try asking

- “Which tasks in the Acme project are still in progress?”
- “Stop my running timer.”
- “Add an expense for today's hosting bill: $24.”

## Access and cost

- You choose view only or view and edit on the PineBill consent screen when you sign in.
- Codex acts as you: your PineBill role and plan limits still apply, and Guests are always view only.
- Disconnect Codex at any time in Settings → Connect MCPs; it loses access on its next request.
- Working through MCP doesn't use PineBill AI credits.

## Other apps

- [Claude](https://www.pinebill.app/features/mcp/claude) — Markdown at https://www.pinebill.app/features/mcp/claude.md
- [ChatGPT](https://www.pinebill.app/features/mcp/chatgpt) — Markdown at https://www.pinebill.app/features/mcp/chatgpt.md
- [Cursor](https://www.pinebill.app/features/mcp/cursor) — Markdown at https://www.pinebill.app/features/mcp/cursor.md
- [VS Code](https://www.pinebill.app/features/mcp/vs-code) — Markdown at https://www.pinebill.app/features/mcp/vs-code.md
- [Claude Code](https://www.pinebill.app/features/mcp/claude-code) — Markdown at https://www.pinebill.app/features/mcp/claude-code.md

## Links

- [Codex setup page](https://www.pinebill.app/features/mcp/codex): this page.
- [Full Codex guide](https://www.pinebill.app/docs/mcp/developer-tools#codex): step-by-step documentation.
- [MCP Server](https://www.pinebill.app/features/mcp): what the MCP server does. Markdown at https://www.pinebill.app/features/mcp.md.
- [Available tools](https://www.pinebill.app/docs/mcp/available-tools): every tool and its access level.
- [Sign up](https://www.pinebill.app/auth/signup): start a 7-day free trial, no credit card required.