invoice

The Invoice MCP server provides a natural language interface for generating professional PDF invoices. It uses the MCP framework to parse user requests and produce invoice data that can be rendered into a PDF via the embedded invoice template. You can prompt it with concise commands like "+Create an invoice for Jane Doe for web development work+" or provide more detailed item lists and due dates. The server supports a mix of fixed-price items and hourly work, and it guides you through confirmation before generating the final PDF. In Claude Desktop (or other MCP-enabled platforms), ensure the server is configured in the mcpServers section so the tool appears in chat options. The project emphasizes consistent invoice formatting, unique invoice numbering, and safe defaults for dates and currency, while letting you override details as needed.

Prerequisites:

• Node.js v18 or newer
• npm (comes with Node.js)

1. Clone the repository and install dependencies

git clone https://github.com/markslorach/invoice-mcp.git
cd invoice-mcp/server
npm install

2. Build the server

npm run build

3. Run or integrate with Claude Desktop (or your MCP client)

• Ensure the built server index.js is accessible at the path you configure in mcp_config.
• Restart Claude Desktop after configuring the MCP server so it appears in chat tools.

Notes:

• The README indicates the server build outputs to build/index.js, which is what you’ll point Claude/Desktop to in the config.
• If you clone to a different path, update the index.js path in the mcp_config accordingly.

Tips and considerations:

• Ensure you use a direct image URL for any logos if you extend the template, and keep in mind SVG logos are not supported.
• Default currency per project docs includes GBP, USD, CAD, EUR; adjust defaults as needed in your conversation prompts.
• Always confirm invoice details with the user before generating the PDF, especially when handling customer data, dates, and amounts.
• Output defaults: the server follows the provided template for invoice structure; you can customize the template files under the server directory if needed.
• If you encounter issues with the MCP integration, verify the command and path in your Claude Desktop config and restart the application.