Skip to content
MCP server

Peil

MCP server for Peil: log hours, draft invoices and check finances as a Dutch freelancer

Runs locallyStatus and history
Install
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-mcp

Add 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.Required
  • PEIL_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

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  6. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity