Connect Your AI Assistant
You can connect an AI assistant such as Claude directly to your Fiskl account. Once connected, you ask questions in plain language — "who owes me money?" or "invoice Acme for 10 hours of consulting" — and the assistant reads your live data or creates the record for you.
Connect Claude to your Fiskl account · 4:08
Read the transcript
What This Is
Fiskl provides an MCP server. MCP (Model Context Protocol) is an open standard that lets AI assistants use external tools. When you connect it, your assistant gains a set of Fiskl tools it can use on your behalf.
You do not write any code. You authorise the connection once, in the same way you would connect any app to your account, and then work in conversation.
This is different from Fi, the AI CFO built into Fiskl. Fi lives inside the Fiskl app and needs no setup. The MCP connection brings your Fiskl data into an assistant you already use elsewhere, such as Claude.
Before You Begin
- Use an AI assistant that supports MCP connections, such as Claude.
- 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 Assistant
The exact menu names vary between assistants, but the flow is the same.
-
Add the connection in your assistant
In your AI assistant, find the setting for adding a connector, integration, or MCP server. Enter the Fiskl server address:
https://api.fiskl.com/mcp -
Sign in to Fiskl
Your browser opens a Fiskl sign-in page. Sign in with your normal Fiskl account.
-
Review the permissions
Fiskl shows a consent screen listing what the assistant 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.
-
Approve the connection
Clear the checkbox for anything you do not want to grant, then select Allow. The assistant confirms the connection and its Fiskl tools become available.
Start read-only. Approve only the View permissions on your first connection, try a few questions, then reconnect with write permissions when you are confident.
What Your Assistant Can Do
Once connected, your assistant has tools covering most day-to-day accounting work.
| Area | What you can ask for |
|---|---|
| Clients and vendors | List, look up, create, and update clients and vendors |
| Invoices | List, view, create, preview totals, update, send by email, and mark as paid |
| Quotes | List and view quotes |
| Payments | List payments in a date range, and record a payment against an invoice |
| Products and services | List, view, create, and update catalogue items |
| Reports | Profit 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 insights | Top clients, invoice totals, average days to payment, and average days overdue |
| Audit trail | The 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."
How Access Is Controlled
The connection uses the same permission system as the rest of Fiskl. Two rules always apply.
The assistant 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 connection reflects that immediately.
The assistant can only do what you approved on the consent screen. Scopes come in read and write pairs, so you can grant reading without granting changes.
| Scope | What it allows |
|---|---|
contacts:read / contacts:write | Clients and vendors |
invoicing:read / invoicing:write | Invoices, quotes, and line items |
payments:read / payments:write | Payments received |
products:read / products:write | Products and services |
bills:read / bills:write | Bills you owe |
accounting:read / accounting:write | Ledger data and reconciliation |
banking:read / banking:write | Bank connections |
company:read / company:write | Company profile |
reports:read | Financial reports |
taxes:read | Tax rates |
audit:read | The change history |
webhooks:read / webhooks:write | Webhook endpoints |
Sensitive actions are never available to a connected assistant, whatever you approve. These include managing team members, changing your subscription, creating API keys, editing payment instructions on invoices, and posting manual journals.
Working Safely with Write Access
Write permissions let the assistant change real records. Three habits keep this comfortable.
Ask for a preview before creating an invoice. The assistant 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 change history shows exactly what the assistant did and when.
An assistant with invoicing:write can email invoices to your clients. Only grant it to assistants you trust, and confirm the recipient and amount before you approve a send.
Ask for a Missing Feature
When your assistant cannot do something because no 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
The assistant says it has no Fiskl tools
The connection did not complete, or the assistant has not refreshed its tool list. Disconnect the Fiskl connection in your assistant, then add it again and complete the sign-in.
New features are missing after a Fiskl release
Your connection holds the permissions and tools from when you first approved it. Disconnect and reconnect to pick up newly released tools and scopes.
The assistant reports a missing scope error
You did not approve that permission, or you do not hold it yourself. Ask the assistant 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.
Amounts look 100 times too large
The API returns amounts in minor units, so 15000 means 150.00. Assistants normally convert this correctly. If one reports a figure that looks wrong by a factor of 100, ask it to divide by 100 and confirm against Fiskl.
Related Topics
- What You Can Do with the API — The full list of available data and actions
- Fi - Your AI CFO — The AI advisor built into Fiskl
- Build an Automation with AI — Use an AI tool to build a scheduled integration
- Connect Apps with OAuth — The authorisation flow this connection uses
- Roles and Permissions — How permissions control what a connection can do