Peil
MCP server for Peil: log hours, draft invoices and check finances as a Dutch freelancer
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.1.5
- Listing updated
- 2 days ago
About Peil
Peil is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Peil's server is a thin local client of the Peil public API, started with uvx peil-mcp and authenticated by a scoped API key created under Settings, Developer. Its tools cover reads such as unbilled hours, invoice lists, expenses and an orientation snapshot of what is outstanding, overdue and drafted, plus writes for hours, clients, expenses and invoices.
The design is draft-first. draft_invoice only creates a draft, and anything that emails a client sits behind a separate invoices:send scope, so a key without it can never send. Write operations are rate-limited, with hours at 60 a minute, drafts at 20 and sends at 10. Every action appears in the activity log next to the key, and revoking the key cuts access immediately.
Expenses are entered as the receipt reads, with the total, Dutch btw and a category. The README says the server and keys are free on every plan, while features that are Pro in Peil, such as emailing invoices and recurring invoices, stay Pro when driven through a key.
Install
Run in a terminal
claude mcp add peil-mcp --env PEIL_API_KEY='<PEIL_API_KEY>' -- uvx peil-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"peil-mcp": {
"command": "uvx",
"args": [
"peil-mcp"
],
"env": {
"PEIL_API_KEY": "<PEIL_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"peil-mcp": {
"command": "uvx",
"args": [
"peil-mcp"
],
"env": {
"PEIL_API_KEY": "<PEIL_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"peil-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"peil-mcp"
],
"env": {
"PEIL_API_KEY": "<PEIL_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"peil-mcp": {
"command": "uvx",
"args": [
"peil-mcp"
],
"env": {
"PEIL_API_KEY": "<PEIL_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"peil-mcp": {
"command": "uvx",
"args": [
"peil-mcp"
],
"env": {
"PEIL_API_KEY": "<PEIL_API_KEY>"
}
}
}
}Configuration
PEIL_API_KEYScoped API key from Peil under Settings -> Developer settings.RequiredPEIL_API_URLOverride the API base URL. Defaults to https://api.peil.app/api/v1.
Tools this server provides (24)
Taken from the project documentation; the running server may differ.
- list_clients
- List your clients
- get_client_details
- Show one client's details including default rate
- list_unbilled
- List unbilled hours per client for a period
- list_invoices
- List invoices by status or client
- orientation_snapshot
- Show outstanding, overdue, drafts and year-to-date position
- get_reminder_copy
- Read custom reminder email copy and schedule
- list_expenses
- List a year's one-off expenses and which lack receipts
- log_hours
- Add a timesheet entry
- edit_hours
- Edit a timesheet entry
- delete_hours
- Delete a timesheet entry
- create_client
- Create a client
- update_client
- Update a client
- delete_client
- Delete a client
- create_expense
- Add an expense from a receipt
- draft_invoice
- Draft an invoice from unbilled hours
- set_invoice_status
- Change an invoice status without emailing
- update_invoice
- Edit due date, payment date or notes
- delete_invoice
- Delete an invoice
- archive_invoice
- Archive an invoice
- set_reminder_copy
- Write custom reminder copy for a tone and language
- send_invoice
- Email an invoice to the client now
- schedule_send
- Schedule a draft to be emailed later
- cancel_scheduled_send
- Cancel a scheduled send
- send_reminder
- Email a payment reminder
What it does
- Scoped API keys
- Separate scopes for read, hours, clients, expenses, invoices and sending.
- Draft-only invoices
- Invoices are created as drafts and nothing reaches a client without the send scope.
- Timesheet tools
- Log, edit and delete hours, using the client's default rate unless one is given.
- Receipt expenses
- Add an expense with total, Dutch btw and category from a receipt the assistant reads.
- Financial snapshot
- Check outstanding, overdue, draft and year-to-date positions.
- Activity log
- Every action taken with a key shows in the log next to it.
Good for
- Log billable hours by prompt at the end of a work day
- Draft a month's invoice for one client from unbilled hours
- Ask how much is outstanding and what has been invoiced this year
- File an expense from a receipt with Dutch btw
- Write payment reminder copy in a chosen tone
Pricing
Freemium
Server and keys free on every plan; Pro adds sending, recurring invoices and reminders; Pro price not listed
Prices change. Check peil.app before you buy.
Peil FAQ
Can the assistant email my clients?
Only if the key has the separate Send invoices scope; otherwise it can create drafts only.
Is the MCP server free?
The README says keys and the server are free on every plan, though Pro features stay Pro.
What do I need to run it?
Python 3.11 or newer with uv or pipx, and a Peil API key in PEIL_API_KEY.
Which assistants work with it?
Claude Desktop, Claude Code, Gemini CLI, Codex CLI and other clients that can launch a local MCP command.
Is Peil free?
Peil has a free plan, with paid plans for more usage or features.
How do I add Peil to Claude Code?
Run this command in your terminal: claude mcp add peil-mcp --env PEIL_API_KEY='<PEIL_API_KEY>' -- uvx peil-mcp
What are the best alternatives to Peil?
The closest alternatives to Peil are Ha MCP, Concord MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and Budget Tracker.
Alternatives to Peil

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity