ifirma-mcp-server
MCP server for the iFirma.pl Polish accounting API. Enables AI assistants (Claude, Cursor, Windsurf) to manage invoices, expenses, contractors, and more through natural language.
Setup
Claude Code
claude mcp add ifirma \
-e [email protected] \
-e IFIRMA_API_KEY_INVOICE=hex_key_faktura \
-e IFIRMA_API_KEY_EXPENSE=hex_key_wydatek \
-e IFIRMA_API_KEY_ACCOUNT=hex_key_abonent \
-e IFIRMA_API_KEY_RECEIPT=hex_key_rachunek \
-- npx -y ifirma-mcp-server
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"ifirma": {
"command": "npx",
"args": ["-y", "ifirma-mcp-server"],
"env": {
"IFIRMA_USERNAME": "[email protected]",
"IFIRMA_API_KEY_INVOICE": "hex_key_faktura",
"IFIRMA_API_KEY_EXPENSE": "hex_key_wydatek",
"IFIRMA_API_KEY_ACCOUNT": "hex_key_abonent",
"IFIRMA_API_KEY_RECEIPT": "hex_key_rachunek"
}
}
}
}
Other MCP clients
Run via npx -y ifirma-mcp-server with the environment variables below.
API Keys
- Log in to ifirma.pl
- Go to Settings > API
- Generate keys for: Faktura, Wydatek, Abonent
- Copy the hex keys into environment variables
Environment Variables
* At least one API key is required.
Available Tools
Invoices (faktura key)
Contractors (faktura key)
Payments (faktura key)
VAT Rates (faktura key)
Expenses (wydatek key)
Account (abonent key)
Orders (abonent key)
HR (abonent key)
Development
git clone https://github.com/adriandmitroca/ifirma-mcp-server.git
cd ifirma-mcp-server
npm install
npm run dev
npm test # Unit tests (no API access needed)
IFIRMA_DRY_RUN=true npm run dev # Dry-run mode
See CONTRIBUTING.md for more details.
License
MIT