Use NeetoInvoice in Claude Code

Check requirements

• Claude Code installed on your computer.
• A NeetoInvoice account.

Connect NeetoInvoice to Claude Code

claude mcp add --transport http --scope user neetoinvoice \
  https://connect.neetoinvoice.com/mcp/messages

Start Claude Code, run /mcp, select neetoinvoice, and sign in to your NeetoInvoice account.

Connect with an API key

An API key is not tied to a person. Every tool call reaches the whole workspace, and role checks do not run. Use a key for automation that must see every time entry. Do not use one on a machine where the person should see only their own entries.

The key is the same one the REST API uses. Learn how to get one in the API keys article. Send it in this header:

Authorization: Bearer YOUR_API_KEY

In Claude Code, Codex, Cursor, Antigravity CLI, VS Code, and Devin, leave the key out of the config to sign in with OAuth. Put the key in to use the API key.

Add the server to ~/.claude.json, then restart Claude Code.

{
  "mcpServers": {
    "neetoinvoice": {
      "type": "http",
      "url": "https://connect.neetoinvoice.com/mcp/messages",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Let Claude Code use the CLI

You don't have to write these scripts yourself. Claude Code, Codex, or another coding agent can write the automation and use the open-source NeetoInvoice CLI to work with your account. Run neetoinvoice setup claude (or setup codex, setup cursor) once, then ask:

Every weekday at 10 AM, use the NeetoInvoice CLI to message anyone who didn't log time yesterday on Slack. Write the script, test it, and set up the cron job.

Using the NeetoInvoice CLI, write a script that exports last month's hours per person and per project to a spreadsheet for payroll.

You get the convenience of a chat, and the result is a script you can read, run, and commit.

Try these prompts

Clients, projects, and recipients

Get details for client Acme Corp.

Which projects is oliver@example.com on?

Add accounts@example.com as an invoice recipient for Acme Corp.

Invoices

Email the last invoice to Acme Corp's recipients.

Reports, PTO, and team

Show the payroll summary for July 2026.

Show the monthly PTO report for July 2026.

List all active team members.

Work across workspaces

Which NeetoInvoice workspaces can you see?

Troubleshooting

Your AI assistant shows no NeetoInvoice tools

Restart the client first. Every client reads its MCP config at startup. On Claude or ChatGPT, confirm that you added the connector and finished the sign-in. In ChatGPT, the plugin is created only after you tick I understand and want to continue.

On Claude Code, Cursor, Codex, VS Code, Devin, Antigravity, or Antigravity CLI, check these:

1. The config key. Claude Code, Cursor, Devin, Antigravity, and Antigravity CLI use mcpServers. VS Code uses servers. Codex uses a [mcp_servers.<name>] section in TOML. A server under the wrong key is ignored silently.
2. The URL key. Antigravity and Antigravity CLI expect serverUrl. Claude Code, Codex, Cursor, Devin, and VS Code expect url.
3. The endpoint. It is https://connect.neetoinvoice.com/mcp/messages, with no trailing slash.
4. The syntax. In JSON, a trailing comma or an unclosed brace makes the whole file unreadable.

The connection is refused or unauthorized

With an API key, the Authorization header must read Bearer YOUR_API_KEY, with the word Bearer and a single space before the key. Confirm the key is not revoked and belongs to the workspace you expect. A key from one workspace does not work in another. With OAuth, remove the connector and add it again to run the sign-in from the start.

More fixes are in the NeetoInvoice MCP troubleshooting guide.

Frequently asked questions

Can I use NeetoInvoice with Claude Code?

Yes. You can connect Claude Code directly to the NeetoInvoice MCP server using claude mcp add, or run neetoinvoice setup claude to let Claude Code use the NeetoInvoice CLI. You can also use both.

Use NeetoInvoice in other AI assistants

Prefer the terminal? The NeetoInvoice CLI reaches the same data from your shell, your scripts and your coding agent.