Connecting Aureli to Claude

Step-by-step guide to connecting your Aureli portfolio data to Claude Desktop or Claude Code using the MCP server.

Updated 6 November 2026 · 3 min read

Aureli's MCP server lets you connect your portfolio data to Claude Desktop or Claude Code, so you can ask about your finances directly in Claude.

This feature is available on every Aureli plan, including Lite.

Connecting via Claude Desktop

  1. Open Claude Desktop and go to Settings (click the gear icon or press Cmd + , on Mac / Ctrl + , on Windows).
  2. Navigate to the Integrations section.
  3. Click Add Integration or Add MCP Server.
  4. Enter the following URL:
https://aureli.app/api/mcp
  1. Give the integration a name (e.g. "Aureli").
  2. Click Save or Connect.
  3. A browser window will open asking you to sign in to Aureli (if you aren't already) and authorise the connection.
  4. Choose which permissions to grant — read portfolios, edit portfolios, or both.
  5. Confirm the authorisation. You'll be redirected back to Claude Desktop.

You can now ask Claude questions like "What's my net worth?" or "Show my asset allocation" and it will pull live data from your Aureli account.

Connecting via Claude Code

If you use Claude Code (the CLI), add the MCP server with the claude mcp add command:

claude mcp add --transport http aureli https://aureli.app/api/mcp
  1. Run the command above in your terminal.
  2. Follow the OAuth prompt that opens in your browser to sign in to Aureli (if you aren't already) and authorise the connection.
  3. Choose which permissions to grant — read portfolios, edit portfolios, or both.

If you'd rather configure it manually, you can add Aureli to the mcpServers section of .mcp.json (project scope) or ~/.claude.json (user scope) instead:

{
  "mcpServers": {
    "aureli": {
      "type": "http",
      "url": "https://aureli.app/api/mcp"
    }
  }
}

What Claude can access

Once connected, Claude can use the following tools depending on the permissions you granted:

  • Read portfolios — view your portfolios, assets, debts, valuations, net worth, and allocation data, plus your UK tax year allowance checklist for portfolios held in pounds
  • Edit portfolios — add and edit assets and debts (including stocks, crypto and commodities), record valuations, buys and sells and cost basis, archive or restore items and delete a valuation, trigger an on-demand sync with your connected banks, and file bank transactions under spending categories

Claude can also see your account's subscription and billing status (Lite or Pro, and your renewal or expiry date, if one is on record) — this isn't tied to a specific portfolio. And if you've switched on transaction data for a bank connection, it can list your transaction-enabled accounts, read their transactions, and break your spending down by category. See Tracking Bank Transactions.

Revoking access

To disconnect Claude from your Aureli account, go to Profile → Security → Connected Apps and click Revoke next to the Claude entry. See Managing connected apps for more details.

Troubleshooting

  • Connection not appearing? Make sure you completed the authorisation step in your browser. Check that you're signed in to the correct Aureli account.
  • Data not updating? Claude fetches live data on each request. If values seem stale, check that your Aureli portfolio is up to date.

Feedback

Was this article helpful?

Use with an AI assistant

Copy this article as Markdown to paste into a chat.

Support

Can’t find what you need?

Tell us what you were trying to do and what happened instead. We reply by email, and you can follow the ticket here.