Skip to main content

Connect Your Preferred AI

Connect your preferred AI, such as Claude, to your Fiskl account through Fiskl MCP. Once connected, you ask questions in plain language โ€” "who owes me money?" or "invoice Acme for 10 hours of consulting" โ€” and your preferred AI reads your live data or creates the record for you.

Connect Claude to your Fiskl account ยท 4:08

Read the transcript
In this video we connect Claude to your Fiskl account so you can ask questions about your business and create invoices in plain language. Start in your AI assistant and find the setting for adding a connector or MCP server. Enter the Fiskl server address, then sign in with your normal Fiskl account when the browser opens. Fiskl shows a consent screen listing the permissions the assistant is asking for, such as viewing your invoicing or managing your contacts. Clear the checkbox for anything you do not want to grant. We recommend approving only the view permissions on your first connection, trying a few questions, then reconnecting with write permissions once you are confident. Select Allow to finish. Back in the assistant, the Fiskl tools are now available. Remember that the assistant can never do more than you can yourself, and it can only do what you approved on the consent screen.

What This Isโ€‹

Fiskl MCP is Fiskl's MCP server. MCP (Model Context Protocol) is an open standard that lets AI use tools from other services. When you connect, your preferred AI can use Fiskl MCP tools on your behalf.

You do not write any code. You authorise the MCP connection once, in the same way you would connect any app to your account, and then work in conversation.

info

Fi is Fiskl's built-in AI CFO. Fiskl MCP lets you use your preferred AI, such as Claude, with your authorised Fiskl data and tools. Fi lives inside the Fiskl app and needs no setup. See Fi - Your AI CFO.

Before You Beginโ€‹

  • Your preferred AI must support MCP connections, as Claude does.
  • You need a Fiskl account you can sign in to, with the permissions you want to grant.
  • You can only grant permissions you already hold in Fiskl.

Connect Your Preferred AIโ€‹

The exact menu names vary from one AI to another, but the flow is the same.

  1. Add the connection in your preferred AI

    In your preferred AI, find the setting for adding a connector, integration, or MCP server. Enter the Fiskl MCP server address:

    https://my.fiskl.com/mcp
  2. Sign in to Fiskl

    Your browser opens a Fiskl sign-in page. Sign in with your normal Fiskl account.

  3. Review the permissions

    Fiskl shows a consent screen listing what your preferred AI is asking for, such as View and manage your invoicing and View your reports. Each permission maps to a scope described in How Access Is Controlled.

  4. Approve the connection

    Clear the checkbox for anything you do not want to grant, then select Allow. Your preferred AI confirms the MCP connection, and the Fiskl MCP tools become available.

tip

Start read-only. Approve only the View permissions when you first connect, try a few questions, then reconnect with write permissions when you are confident.

Connect Claudeโ€‹

Claude supports Fiskl MCP directly, in both the desktop and web apps.

  1. Go to Settings > Connectors and select Add custom connector.
  2. Enter Fiskl as the name and https://my.fiskl.com/mcp as the server address.
  3. Select Add, then select Connect to start the Fiskl sign-in.
  4. Sign in to Fiskl and approve the permissions you want to grant.

The Fiskl MCP tools then appear in Claude's tool menu.

To connect Claude Code, run the following in your terminal:

claude mcp add --transport http fiskl https://my.fiskl.com/mcp

Then run /mcp, select Fiskl, and complete the sign-in.

Claude also offers four ready-made prompts for common jobs. Open the prompt picker and look for Financial health check, Who owes me money?, Month-end review, and Create and send an invoice. Each one runs a full sequence of Fiskl MCP tools, so you do not need to know which to ask for.

What Your Preferred AI Can Doโ€‹

Once connected, your preferred AI can use Fiskl MCP tools covering most day-to-day accounting work.

AreaWhat you can ask for
Clients and vendorsList, look up, create, and update clients and vendors
InvoicesList, view, create, preview totals, update, send by email, and mark as paid
QuotesList and view quotes
PaymentsList payments in a date range, and record a payment against an invoice
Products and servicesList, view, create, and update catalogue items
ReportsProfit and loss, balance sheet, trial balance, cash flow, financial ratios, AR and AP aging, general ledger, transaction detail, statement of account, and tax reports
Business insightsTop clients, invoice totals, average days to payment, and average days overdue
Audit trailThe change history for a record, and a company-wide feed of recent changes

Some example requests that work well:

  • "What were my top five clients by revenue last quarter?"
  • "Show me every overdue invoice and how late each one is."
  • "Create an invoice for Acme Corp: 10 hours of consulting at 150 per hour, due in 30 days."
  • "Record a 500 payment against invoice INV-0042, received today."
  • "Run a profit and loss for last month and explain the biggest changes."

Find Out Why, Not Just Whatโ€‹

Your preferred AI does not stop at the report. When a figure looks wrong, it follows the number down to the entry behind it.

Ask why your current ratio dropped this quarter, and it reads the ratios, then the balance sheet, the general ledger, and the individual transactions until it finds the entry that explains the change. That might be a misclassified expense, a payment posted to the wrong ledger account, or a transaction entered the wrong way round.

Questions that work well:

  • "My gross margin is lower than last month. What changed?"
  • "Cash flow looks worse than my profit suggests. Why?"
  • "This ledger account balance looks wrong โ€” show me the transactions behind it."
  • "Something changed on this invoice. Who edited it, and what did they change?"

Work like this normally means an hour of filtering and exporting. In conversation it takes a few minutes, and your preferred AI shows the figures it used so you can verify them in Fiskl.

How Access Is Controlledโ€‹

The MCP connection uses the same permission system as the rest of Fiskl. Two rules always apply.

Your preferred AI can never do more than you can. Your permissions are the ceiling, and every request is checked against them at the time it is made. If your permissions change, the MCP connection reflects that immediately.

Your preferred AI can only do what you approved on the consent screen. Where a scope has both a read and a write form, you can grant reading without granting changes. Reports, tax rates, and the Audit Log are read-only, so your preferred AI can never alter them.

ScopeWhat it allows
contacts:read / contacts:writeClients and vendors
invoicing:read / invoicing:writeInvoices, quotes and line items
payments:read / payments:writePayments received
products:read / products:writeProducts and services
bills:read / bills:writeBills you owe
accounting:read / accounting:writeLedger data and reconciliation
banking:read / banking:writeBank connections
company:read / company:writeCompany profile
reports:readFinancial reports
taxes:readTax rates
audit:readAudit Log and change history
webhooks:read / webhooks:writeWebhook endpoints
invoicing:sendSending invoices and quotes by email
transactions:writeRecording expenses, income, transfers, supplier bills and customer receivables, and registering fixed assets
inventory:readStock levels and valuation
purchasing:readPurchase orders

Sensitive administrative actions are never available through Fiskl MCP, whatever you approve. These include managing team members, changing your subscription, creating API keys, editing payment instructions on invoices, posting manual journals, and connecting, changing or removing bank connections.

Your preferred AI cannot delete records such as invoices, clients, or transactions through Fiskl MCP.

Every action performed through Fiskl MCP, read or write, is recorded in Fiskl's Audit Log. The record identifies the authorising user, the AI used, the time, the action and outcome, and the affected record where applicable. MCP actions remain subject to the user's Fiskl permissions and the scopes approved during authorisation.

Working Safely with Write Accessโ€‹

Write permissions let your preferred AI change real records. Three habits keep this comfortable.

Ask for a preview before creating an invoice. Fiskl MCP can calculate the totals and taxes without saving anything, so you can check the figures first.

Confirm before sending. Sending an invoice emails your client immediately and cannot be recalled.

Check the work afterwards. Records created this way appear in Fiskl like any other, and the Audit Log shows exactly what your preferred AI did and when.

warning

With invoicing:send, your preferred AI can email invoices to your clients. Only grant it to an AI you trust, and confirm the recipient and amount before you approve a send.

Use It in Automationsโ€‹

Fiskl MCP is not limited to conversation. MCP is an open standard, so the same tools work in automation platforms and scheduled workflows. The invoicing, reconciliation, and reporting you do by asking can also run unattended.

Common patterns include raising an invoice when a job is marked complete in another system, reconciling payments on a schedule, and posting a weekly summary of overdue invoices to your team chat.

See Build an Automation with AI to get started.

Ask for a Missing Featureโ€‹

When your preferred AI cannot do something because no Fiskl MCP tool exists for it, it can file a request with the Fiskl team. Ask it to "request this feature in Fiskl" and it records what you were trying to do.

The team reviews these requests and they shape what gets built next. This is one of the fastest ways to influence the roadmap.

Common Issuesโ€‹

Your preferred AI says it has no Fiskl tools

The MCP connection did not complete, or your preferred AI has not refreshed its tool list. Disconnect Fiskl in your preferred AI, then add it again and complete the sign-in.

New features are missing after a Fiskl release

The MCP connection holds the scopes and tools from when you first approved it. Disconnect and reconnect to pick up newly released tools and scopes.

Your preferred AI reports a missing scope error

You did not approve that scope, or you do not hold the permission yourself. Ask your preferred AI to check its permissions, then reconnect and approve the scope you need. If it is unavailable on the consent screen, you do not hold that permission โ€” ask an administrator to grant it.

Your preferred AI cannot see a client or invoice that exists in Fiskl

Two things narrow what the MCP connection can see. You may not have approved the scope that covers it, and some records are only visible to the person who created them โ€” invoices and quotes work this way for users without write access.

Ask your preferred AI to check its permissions, and confirm you can see the record yourself in Fiskl.

The connection is refused with a subscription error

The MCP connection needs an active Fiskl subscription. If yours has lapsed, renew it in Settings > Subscription and connect again.

Amounts look 100 times too large

The API returns amounts in minor units, so 15000 means 150.00. Your preferred AI normally converts this correctly. If it reports a figure that looks wrong by a factor of 100, ask it to divide by 100 and confirm against Fiskl.