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
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.
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.
-
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 -
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 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.
-
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.
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.
- Go to Settings > Connectors and select Add custom connector.
- Enter
Fisklas the name andhttps://my.fiskl.com/mcpas the server address. - Select Add, then select Connect to start the Fiskl sign-in.
- 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.
| 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."
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.
| 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 | Audit Log and change history |
webhooks:read / webhooks:write | Webhook endpoints |
invoicing:send | Sending invoices and quotes by email |
transactions:write | Recording expenses, income, transfers, supplier bills and customer receivables, and registering fixed assets |
inventory:read | Stock levels and valuation |
purchasing:read | Purchase 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.
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.
Related Topicsโ
- What You Can Do with the API โ The full list of available data and actions
- Fi - Your AI CFO: Fiskl's built-in AI CFO
- 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 the MCP connection can do