Codex · MCP
Connect Codex to your finances
Codex reads MCP servers from its config file. Add one block for 2Fin, sign in from the terminal, and ask about tool costs, subscriptions and client income while you work.
Add 2Fin to Codex now
Codex comes first; the same server works in the others. Every route signs you in to 2Fin and shows the consent screen before anything is shared.
Claude
One clickOpens Claude's add-connector dialog with 2Fin filled in. Claude shows it came from a link, and you confirm.
Paste the first into Claude. A chat cannot install software or click settings for you, so it explains each step. The second is the first prompt to send once you are connected, in a new chat.
What happens, and the manual way
If the link does not open, this is what the copy button holds:
https://api.ai2fin.com/mcp- Select Add to Claude. It opens claude.ai with the name 2Fin and the URL https://api.ai2fin.com/mcp already in the Add custom connector dialog; sign in to Claude first if it asks.
- Check the name and URL, then select Add. By hand, the same dialog is under Customize, Connectors, Add, Add custom connector.
- Select Connect. Sign in to 2Fin, read the consent screen, which names every permission, and approve. Approve only the read permissions to keep it read-only.
- Custom connectors are on Claude’s Free, Pro, Max, Ultra, Team and Enterprise plans (Free allows one; on Team and Enterprise an Owner adds it).
Anthropic: custom connector install link · docs read 19 Nov 2026
ChatGPT
Copy and pasteChatGPT has no install link, so copy the URL and add 2Fin as a custom MCP server on the web.
Paste the first into ChatGPT. A chat cannot install software or click settings for you, so it explains each step. The second is the first prompt to send once you are connected, in a new chat.
Steps
https://api.ai2fin.com/mcp- On the ChatGPT web app, open ChatGPT Plugins (chatgpt.com/plugins), which is where OpenAI puts custom MCP servers, select the plus button, then Add custom MCP server.
- Enter the name 2Fin, and under Connection paste the server URL.
- Under authentication choose OAuth.
- Read the risk warning, select I understand and want to continue, then Create. Install it from your plugins before you use it in a conversation.
- When ChatGPT asks to connect: Sign in to 2Fin, read the consent screen, which names every permission, and approve. Approve only the read permissions to keep it read-only.
- OpenAI’s workspace permissions and Lockdown settings apply, and its guide does not list plan tiers: check the guide below for yours.
OpenAI: add a custom MCP server · docs read 19 Nov 2026
Cursor
One clickOpens Cursor's MCP install link with 2Fin filled in, so there is nothing to type.
Paste the first into Cursor. The setup file tells it to stop and ask before it runs anything. The second is the first prompt to send once you are connected, in a new chat.
What happens, and the manual way
If the link does not open, this is what the copy button holds:
{ "mcpServers": { "2fin": { "url": "https://api.ai2fin.com/mcp" } } }- Select Add to Cursor. It opens Cursor with the install link for 2fin; follow Cursor's prompts to finish.
- By hand, select Copy Cursor mcp.json and add the entry to mcp.json (Cursor Settings, then MCP), or to .cursor/mcp.json in a project.
- Cursor supports OAuth for servers that need it. Sign in to 2Fin, read the consent screen, which names every permission, and approve. Approve only the read permissions to keep it read-only.
Cursor: MCP install links · docs read 19 Nov 2026
VS Code
One clickOpens VS Code with 2Fin on its install screen so you can review it first.
Paste the first into VS Code. A chat cannot install software or click settings for you, so it explains each step. The second is the first prompt to send once you are connected, in a new chat.
What happens, and the manual way
- Select Install in VS Code. VS Code opens the details for 2fin so you can review it, then install it.
- VS Code Insiders has its own link in More clients.
- VS Code runs the OAuth sign-in for remote servers that need it. Sign in to 2Fin, read the consent screen, which names every permission, and approve. Approve only the read permissions to keep it read-only.
VS Code: MCP servers, install links · docs read 19 Nov 2026
Claude Code
One commandOne command in your terminal adds 2Fin to Claude Code.
Paste the first into Claude Code. The setup file tells it to stop and ask before it runs anything. The second is the first prompt to send once you are connected, in a new chat.
Steps
claude mcp add --transport http 2fin https://api.ai2fin.com/mcp- Run the command in your terminal.
- Start Claude Code, type /mcp, choose the server and follow the steps in your browser to sign in to 2Fin. Approve only the read permissions to keep it read-only.
Anthropic: connect Claude Code to tools via MCP · docs read 19 Nov 2026
More clients: VS Code Insiders, Windsurf, Gemini CLI, Codex CLI, Grok, Grok Build, Zed, Goose
VS Code Insiders
The same install screen in the Insiders build.
Details
- VS Code Insiders opens the details for 2fin so you can review it, then install it.
VS Code: MCP servers, install links · docs read 19 Nov 2026
Windsurf
Windsurf documents no install link, so paste this into its MCP config.
Details
{ "mcpServers": { "2fin": { "serverUrl": "https://api.ai2fin.com/mcp" } } }- Add the entry to the mcpServers object in Windsurf’s mcp_config.json (its guide gives the location for your system).
- Windsurf supports OAuth for remote servers that need it. Sign in to 2Fin, read the consent screen, which names every permission, and approve. Approve only the read permissions to keep it read-only.
Windsurf: Cascade MCP · docs read 19 Nov 2026
Gemini CLI
One command adds the server to Gemini CLI.
Details
gemini mcp add --transport http 2fin https://api.ai2fin.com/mcpOr in settings.json:
{ "mcpServers": { "2fin": { "httpUrl": "https://api.ai2fin.com/mcp" } } }- In Gemini CLI, run /mcp auth 2fin to sign in to 2Fin, and approve only the read permissions to keep it read-only.
Gemini CLI: MCP servers · docs read 19 Nov 2026
Codex CLI
Add a block to Codex’s config file, then sign in from the terminal.
Paste the first into Codex CLI. The setup file tells it to stop and ask before it runs anything. The second is the first prompt to send once you are connected, in a new chat.
Details
[mcp_servers.2fin] url = "https://api.ai2fin.com/mcp"- Paste the block into ~/.codex/config.toml.
- Run codex mcp login 2fin to sign in to 2Fin, and approve only the read permissions to keep it read-only.
Codex: Model Context Protocol · docs read 19 Nov 2026
Grok
Grok has no install link, so copy the URL and add 2Fin as a custom connector on grok.com.
Details
https://api.ai2fin.com/mcp- On grok.com, open grok.com/connectors, select New Connector, then Custom.
- Paste the server URL for 2Fin. The server must be reachable from the internet, which this one is.
- Complete the authentication Grok asks for. Sign in to 2Fin, read the consent screen, which names every permission, and approve. Approve only the read permissions to keep it read-only.
- xAI’s docs say connectors are available to all Grok users; on Grok Business and Enterprise a team admin provisions a connector first.
xAI: Grok connectors · docs read 20 Nov 2026
Grok Build
One command adds the server to Grok Build, xAI’s command-line assistant.
Details
grok mcp add --transport http 2fin https://api.ai2fin.com/mcp- Run the command in your terminal.
- Grok Build handles OAuth for you: it opens your browser the first time the server is used. Sign in to 2Fin and approve only the read permissions to keep it read-only.
xAI: Grok Build MCP servers · docs read 20 Nov 2026
Zed
Zed documents no install link, so paste this into its settings.
Details
{ "context_servers": { "2fin": { "url": "https://api.ai2fin.com/mcp" } } }- Run zed: open settings file and merge the context_servers entry in.
- With no Authorization header set, Zed prompts you to authenticate: sign in to 2Fin and approve only the read permissions to keep it read-only.
Zed: Model Context Protocol · docs read 19 Nov 2026
Goose
Opens Goose with 2Fin as a remote extension.
Details
- Select Add to Goose. It opens Goose with 2Fin as a remote extension; follow Goose's prompts to finish.
- Goose gets its own client ID for remote extensions that need OAuth. Sign in to 2Fin, read the consent screen, which names every permission, and approve. Approve only the read permissions to keep it read-only.
Goose: using extensions, deeplinks · docs read 19 Nov 2026
Another MCP client takes the same URL: https://api.ai2fin.com/mcp.
Set it up in four steps
- 01
Create a free 2Fin account and add your transactions
Connect a bank feed with your own key or upload a statement. On Premium and up, Fin categorises each transaction as it arrives.
- 02
Add the server to Codex
Paste this block into ~/.codex/config.toml:
[mcp_servers.2fin] url = "https://api.ai2fin.com/mcp" - 03
Sign in
Run codex mcp login 2fin. A 2Fin sign-in page opens with the consent screen; approve only the read permissions to keep it read-only.
- 04
Ask
For example: “What did my developer tools cost this financial year, and which subscriptions went up?”
Menus move between versions; OpenAI’s own guide has the current path: Codex: Model Context Protocol. 2Fin MCP documentation
Things to ask Codex
- “What did I spend on eating out this year, month by month?”
- “Which of this quarter’s purchases look deductible for my work?”
- “What bills are due before my next pay, and will there be enough left?”
- “How much GST is in my business spending this quarter?”
The permissions on the consent screen
read:transactionsRead your transactions, categories and what looks deductibleread:billsRead your bills, recurring payments and what is coming upwrite:transactionsAdd transactions or change their categorywrite:billsAdd or change bills and money you expect to receivewrite:expensesRecord an expense, such as one from a receiptwebhooks:manageSet up webhooks for a developer tool
Approve only the read permissions to keep Codex read-only. Bank connections are read-only either way, and 2Fin masks email addresses, card and other long numbers, BSBs, numbers labelled as account numbers, tax file numbers, ABNs and phone numbers, matched in common Australian formats (an identifier written in another country’s format may not be caught) before anything reaches the assistant.
Questions, answered
Connecting Codex to 2Fin
- Which 2Fin plan do I need to connect Codex?
- Any plan. The MCP server Codex connects to is on the free plan, with no card and no time limit.
- How do I disconnect Codex from 2Fin?
- Remove the 2Fin connector in Codex, and revoke its access from your 2Fin account settings. Revoking in 2Fin stops it at once, whatever Codex still has saved.