With the Milo MCP connection you work in your Milo administration straight from Claude Desktop. You ask in plain language which invoices are still open, have Claude prepare a draft invoice or log hours, and Claude uses your own Milo data to do it.
What you need
- A Milo account with admin rights: only admins can create API tokens.
- Claude Desktop on your computer.
- Node.js (LTS version) from nodejs.org. The connection uses it to connect.
Step 1: create an API token
- In Milo, go to Admin and choose API tokens.
- Create a new token with a recognisable name, for example "Claude Desktop". An expiry date is optional.
- Copy the token right away: it is shown only once.
Treat the token like a password. It gives access to your administration with your permissions. You can revoke it at any time on the same page.
Step 2: add Milo to Claude Desktop
- Open Claude Desktop and go to Settings, tab Developer.
- Choose Edit Config. The file
claude_desktop_config.jsonopens in your editor. - Add Milo under
mcpServersand put your own API token afterBearer:
{
"mcpServers": {
"milo": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.milomoves.app/mcp",
"--header",
"Authorization:${MILO_AUTH}"
],
"env": {
"MILO_AUTH": "Bearer paste-your-api-token-here"
}
}
}
}
Save the file and restart Claude Desktop completely: quit the app and open it again. After that you will find the Milo tools among the tools below the chat input.
What can you ask?
- "Which invoices are still open?"
- "How much have I invoiced this month?"
- "Create a draft invoice for Jansen BV for 8 hours of consultancy."
- "Log 2 hours on the Website project for today."
- "Which hours from last month haven't been invoiced yet?"
What works and what doesn't?
Through the connection Claude can read your administration and prepare work for you: view invoices and quotes, manage customers and projects, log hours and create draft invoices.
Sending, deleting, status changes and bulk actions are deliberately not available through the connection. A draft invoice that Claude prepares is one you review and send yourself in Milo. That way the steps with real consequences always stay in your hands.
Good to know: data that Claude retrieves through the connection becomes part of your conversation with Claude and is covered by the terms of your AI tool.
Not working?
- Don't see the Milo tools? Restart Claude Desktop completely and check that the JSON configuration is valid, for example for a missing comma.
- Getting an authorisation error? The token has probably expired or been revoked. Create a new token in Milo and put it in the configuration.
- Is
npxnot found? Install Node.js and restart your computer.
Other AI tools
The connection uses MCP (Model Context Protocol), an open standard. Other AI tools that support MCP, such as Cursor, connect the same way: same address, same configuration, with your own API token.
Rather not install anything? The Milo assistant is built into Milo web, in the chat at the bottom right, and carries out the same kind of tasks for you.
Still stuck? Ask Milo via the chat in the bottom right, or email [email protected].