Skip to main content

Using the Finary MCP with my AI assistant (Claude, ChatGPT, Perplexity, Mistral)

What your AI assistant can read and change in your Finary account, how your data is handled, and how to cut off access.

Written by Pierre-Luc Schaming

What is the Finary MCP connector?

The Finary MCP connector lets the AI assistant of your choice (Claude, ChatGPT, Perplexity, Mistral, Grok) read the data in your Finary account so it can answer questions about your wealth. You sign in with your Finary account: no API key to create, no banking credentials to enter. If you allow it, it can also create and edit your goals and your manual investment accounts, always after you confirm.

How do you set it up?

The connector URL is the same for every assistant:

https://public-api.finary.com/mcp

Setup takes about a minute. There is no API key to create — you sign in with your Finary account.

On the Finary authorisation screen, you choose what your assistant can do: reading your wealth is required, sharing transactions and making changes are optional. Nothing is ticked by default.

In Claude (claude.ai or Claude Desktop)

Finary is listed in Claude's connector directory: there is no custom connector to create and no URL to paste.

  1. Open Finary's page in Claude's directory: claude.ai/directory/finary-mcp.

  2. Click Connect to Claude.

  3. Finary opens an authorization screen listing what Claude will be able to read — click Authorize read-only access (or Authorize access if you ticked changes).

  4. Ask a first question, for example "What is my portfolio allocation by asset class?"

On Team and Enterprise plans, the button reads Request until an Owner has added Finary for the organization: Organization settings → Connectors → Browse connectors, select Finary, then Add to your team. Everyone else then simply clicks Connect.

If Finary does not appear in the directory, you can still add it by hand: open claude.ai/customize/connectors, click Add, then Add custom connector. Name it Finary, paste https://public-api.finary.com/mcp, click Add, then Connect. On a free Claude plan you can only have one custom connector: if you already have one, Add custom connector appears greyed out.

In Claude Code (terminal)

  1. In your terminal, run claude mcp add --transport http --scope user finary https://public-api.finary.com/mcp

  2. Open Claude Code, type /mcp, select finary and start authentication. Your browser opens Finary’s authorization screen — click Authorize read-only access (or Authorize access if you ticked changes).

  3. Back in the terminal, /mcp shows finary as connected. Ask a first question, for example "What is my portfolio allocation by asset class?"

In ChatGPT

Finary is listed in the ChatGPT plugin directory: no custom connector to create, no URL to paste, and no need to turn on Developer mode anymore.

  1. Open the Finary page in ChatGPT: chatgpt.com/plugins. You can also open Settings → Plugins → Browse plugins and search for Finary.

  2. Click Install plugin.

  3. Sign in with your Finary account. Finary opens an authorization screen listing what ChatGPT will be able to read — click Authorize read-only access (or Authorize access if you ticked changes).

  4. Open a new conversation, enable Finary in the tools, then ask a first question, for example "What is my portfolio allocation by asset class?"

On a ChatGPT Business, Team or Enterprise workspace, installing a plugin can depend on the workspace's own policy. Ask the workspace administrator to allow Finary, or use your personal ChatGPT account.

If Finary does not show up in the directory, you can add it by hand with Developer mode, whose availability depends on your plan and region: turn it on under Settings → Security and login, then in Plugins → Browse plugins, click the + button to the right of the search bar. Name it Finary, paste https://public-api.finary.com/mcp, confirm, then click Connect.

In Grok (grok.com)

Finary is listed in Grok's connector catalogue: there is no custom connector to create and no URL to paste.

  1. Open grok.com/connectors, then click New Connector.

  2. Type Finary in the search bar: it shows up under Finance. Click Add.

  3. Finary shows an authorisation screen listing everything Grok will be able to read: click Authorize read-only access (or Authorize access if you ticked changes).

  4. Ask a first question, for example "How is my wealth split by asset class?"

If Finary does not appear in the catalogue, you can add it manually: in New Connector, choose Custom, paste https://public-api.finary.com/mcp as the MCP server URL and confirm.

In Perplexity (paid plans only)

Finary is listed in Perplexity's connector directory: there is no custom connector to create and no URL to paste.

  1. Open the connector directory: perplexity.ai/computer/connectors. In the left-hand menu it is Customise, then the Connectors tab.

  2. On the Finary card, click the + button.

  3. Finary opens an authorization screen listing what Perplexity will be able to read — click Authorize read-only access (or Authorize access if you ticked changes).

  4. A tab confirms the authentication succeeded — you can close it. Back in Perplexity, Finary is now shown as Connected.

  5. Ask a first question, for example "What is my portfolio allocation by asset class?"

If the Finary card does not appear, you can still add it by hand: in the top right, click Custom connector, then Add custom connector. Name it Finary, paste https://public-api.finary.com/mcp into the MCP server URL field, tick I understand custom connectors can introduce risks, then click Add.

In Mistral Vibe (chat.mistral.ai)

Finary is listed in Vibe's connector marketplace: there is no custom connector to create and no URL to paste.

  1. Open Vibe's connector marketplace: chat.mistral.ai/connections/marketplace.

  2. On the Finary card, click the + button.

  3. Finary shows an authorisation screen listing everything Vibe will be able to read: click Authorize read-only access (or Authorize access if you ticked changes).

  4. Ask a first question, for example "How is my wealth split by asset class?"

In a code editor (Cursor)

The connector URL is the same as everywhere else, and it must start with https://: entered without that prefix, your editor tries to connect over http:// and the connection is refused. There is no API key or client ID to provide — leave those fields empty.

  1. Open Customize → MCPs, then New MCP Server. You can also edit ~/.cursor/mcp.json directly.

  2. Paste in: { "mcpServers": { "finary": { "url": "https://public-api.finary.com/mcp" } } }

  3. Cursor opens your browser on Finary’s authorization screen — click Authorize read-only access (or Authorize access if you ticked changes).

  4. The server then shows as connected in the MCPs tab. Ask a first question, for example "What is my portfolio allocation by asset class?"

In the Gemini app (web and mobile)

The Gemini app (web and mobile) does not yet let you add the Finary connector outside the US. For now, Google only lets users add custom MCP connectors if they are in the US, 18 or over, signed in with a personal Google Account and using Gemini in English. This restriction is on Google's side: no setting in your Finary account can lift it.

We are working on making Finary available in the Gemini app and will update this page as soon as it is possible.

In Gemini CLI (terminal)

Google no longer accepts Gemini CLI sign-in with a personal Google Account: first sign Gemini CLI in with a Gemini API key (or Vertex AI), then follow these steps.

  1. In your terminal, run gemini mcp add --scope user --transport http finary https://public-api.finary.com/mcp

  2. Open Gemini CLI and type /mcp auth finary. Your browser opens Finary’s authorization screen: click Authorize read-only access (or Authorize access if you ticked changes).

  3. Back in the terminal, /mcp list shows finary as connected. Ask a first question, for example "What is my portfolio allocation by asset class?"

If Gemini CLI asks whether you trust the folder, accept: in an untrusted folder, Gemini CLI disables every MCP server, Finary included.

If the connection fails

  • The URL is missing its prefix. It must start with https:// — without it, your client falls back to http:// and the connection is refused.

  • You are using a VPN. Some VPNs trigger a security check that makes the connection fail. Turn it off while you connect the connector, then switch it back on.

  • “Authorization with Finary failed”: two possible causes. First check that AI assistants are allowed on your account: open Security from your Finary account menu and make sure Allow AI assistants (MCP) is switched on. If that setting is off, every connection attempt fails with this message. Otherwise the connector's access has already been removed. You then need to run the authorization again, not just reconnect: start it from your assistant (the Connect button, or by removing and re-adding the connector), then click Allow read-only access once more. If the message shows a reference starting with ofid_, send it to us — it lets us find the attempt.

  • The connector shows as connected but no tools appear: close and reopen your assistant. If it persists, write to us.

  • Your assistant keeps asking you to authorize again, or the authorization succeeds and then immediately fails: write to us with the assistant you are using and the exact time of your last attempt. Those two details let us find your attempt in our logs, and nothing you can do on your side replaces them.

  • Your assistant says it cannot access your transactions: either this access was not allowed when you connected (authorise again as described in "How do I give access to my transactions?"), or your plan does not include Budget.

  • Your assistant says it cannot create or change your data: check that Allow changes is on in Security, then refresh the Finary tools in your assistant (or close and reopen it). If it refuses to record a transaction in a specific account, that account may be an older manual account or a synced account (see "What can your assistant create or change?").

Which assistants can I connect?

The connector works with any MCP-compatible client. Nothing in your account restricts which assistant you choose — if a connection fails, it is never because your assistant is not “allowed”.

The paths described above are the ones we have verified and can help you with. Other clients connect too, without us describing each one.

If you hit an error, write to us with the assistant you used and the message shown — that is what lets us unblock them.

What should I choose on the authorisation screen?

The authorisation screen offers three kinds of access:

  • View your wealth and budget (required): your accounts, holdings, goals, budget and spending totals.

  • View your transactions (optional): the date, amount, label, category and account of each transaction.

  • Create and edit your Finary data (optional): your goals and your manual investment accounts.

You can turn off each of these at any time in Settings › Security.

What data can your assistant read?

Exactly the categories the authorisation screen lists for you before you approve:

  • Your net worth and how it's split — including per family member

  • Your accounts, holdings, property, loans and other assets

  • Your income, spending and budgets, and up to two years of history behind them

  • Your individual transactions (date, amount, label, category and sub-category, account), only if you allow it on the authorisation screen

  • Your goals and plans

  • The family and companies you've added

  • Your name, email and linked-account status

This data comes from your Finary account: the connections you have set up through our authorised partners (Powens, Flanks, Plaid) and the accounts you have entered manually. Your banking credentials are never passed to your assistant — they stay with those partners, and Finary has no access to them.

How do I give access to my transactions?

Your assistant can read your individual transactions to answer questions such as "What are my recurring expenses?" or "When did I pay my Netflix subscription?". This access is optional: you choose it on the authorisation screen when you connect Finary.

If your assistant was already connected to Finary, simply reconnecting is not enough: you need to authorise again.

  1. Remove the Finary connector from your assistant (see "How do you cut off access?" below).

  2. Add it again by following the installation steps above.

  3. On the Finary authorisation screen, allow access to individual transactions, then click Authorise read-only access.

Transaction details are part of Budget, which is reserved for Finary subscribers: your assistant gets them on the same terms as the app. Without a subscription, it will tell you that the transaction list is not included in your plan.

As the authorisation screen states, your transactions can reveal sensitive information (health, religion, political opinions or trade union membership). You can withdraw this access at any time by removing the connector.

Even if you allow changes, your assistant cannot recategorise, edit or delete a transaction from your bank accounts. Your counterparties' IBANs are never sent to it.

What can your assistant create or change?

If you have allowed changes, your assistant can:

Your goals

  • Create a goal: a project with an amount and a date (buying a car, a home deposit…), with a regular contribution if you like, or an emergency fund sized in months of expenses.

  • Edit an existing goal: name, amount, date, contributions, the accounts that fund it.

A goal is always linked to at least one of your accounts: your assistant asks you which ones to use and never picks them for you. The balance of those accounts counts toward the goal straight away. Your plan's limits apply as in the app.

Your manual investment accounts

  • Create or edit an account: securities account (CTO), PEA, life insurance, PEE, PER or PERCO.

  • Record your buys, sells, deposits, withdrawals and fees in it, for example from a screenshot or a PDF statement from your broker, and correct a buy or sell already recorded.

Your assistant records and edits transactions in the accounts it created and in manual investment accounts created since late October 2026. For an older manual account or a synced account, this is not possible yet: add those transactions in the app.

Your date of birth, if it is missing to calculate your financial independence.

Nothing is saved without your agreement. Your assistant first shows you a preview (and, for a change, the previous and the new value). The change is only applied once you confirm, and then shows up in the web and mobile app.

What your assistant cannot do: delete anything, change a goal's colour or type, record crypto or dividends, or change your synced accounts. To delete a goal, an account or a transaction, use the Finary app.

How do I allow changes?

When you connect: on the Finary authorisation screen, tick Create and edit your Finary data, then click Authorize access.

If your assistant is already connected, there is no need to reconnect it:

  1. Open Security in your Finary account menu and turn on Allow changes.

  2. In your assistant, refresh the Finary tools if it offers that option, or close and reopen it.

Every change made by an assistant is logged in Finary.

Can your assistant act on your accounts?

Your assistant can never move money: it cannot place orders, make transfers or delete anything in your Finary account. Unless you allow changes, it only reads your data. If you do, it can only create and edit your goals and your manual investment accounts, after you confirm. It only accesses your own data: the connector gives access to no account other than yours.

How is your data handled?

  • Nothing is shared unless you ask: your data is sent only when you put a question to your assistant, and only to the assistant you have connected.

  • The assistant you connect (Anthropic's Claude, OpenAI's ChatGPT, Perplexity, Mistral, Grok) receives your data solely upon your instruction and acts as an independent data controller, in accordance with its own privacy policy. How long your conversations are kept, and whether they are used to train its models, is therefore governed by that assistant and not by Finary.

  • Depending on the assistant you connect, your data may be processed outside the European Union, in accordance with that assistant's own privacy policy. The legal basis for this sharing is your explicit consent, collected when you activate the connector and revocable at any time.

  • Access tokens and connection logs are kept for 12 months from the revocation of the connector. No data is stored by Finary with the assistant provider.

  • Every change made by an assistant is logged in Finary, with the previous and the new value. Finary never stores the content of your conversations.

Full details are in our privacy policy.

How do you cut off access?

Remove the Finary connector in your assistant (Claude, ChatGPT, Perplexity, Mistral, Grok): it then stops accessing your data. Nothing is changed in your accounts or your positions. If you want to use it again later, you will have to go through the authorization screen again — reconnecting on its own is not enough.

To remove only changes, open Security in your Finary account menu and turn off Allow changes. Your assistants keep reading your data but can no longer add or change anything. What was already created or changed stays in Finary.

To cut off every assistant at once, open Security from your Finary account menu and turn off Allow AI assistants (MCP). Every assistant you connected through Finary then loses access, including the ones in use right now; it can take a few minutes to fully apply. You can allow access again at any time. This setting is available on the web and in the mobile app.

Does my assistant give investment advice?

No. Your assistant reads and describes your wealth. None of its answers constitutes personalised investment advice, and Finary does not give an opinion on the suitability of your investments through this channel.

When it creates a goal or records a transaction, it does so at your request and with the figures you give it.

Related Articles
Did this answer your question?