About Bill4Time MCP by usefulapi
Bill4Time MCP by usefulapi is a hosted MCP server for reading Bill4Time records from MCP clients. It covers billing and timekeeping data with typed filters and sorting, while withholding confidential fields.
Key features
- 01Read clients and projects
- 02Read time entries and expenses
- 03Read invoices and payments
- 04Read users and contacts
- 05Filter and sort results
- 06Exclude confidential fields
Use cases
- 01Review client and project records
- 02Inspect recorded time and expenses
- 03Check invoices and payment records
- 04Retrieve records while omitting sensitive fields
MCP support
Exposes read-only Bill4Time records to MCP clients, including typed filters and sorting. It requires a Bill4Time v1 API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://bill4time.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-bill4time https://bill4time.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-bill4time":{"type":"http","url":"https://bill4time.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-bill4time":{"type":"http","url":"https://bill4time.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-bill4time":{"type":"http","url":"https://bill4time.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-bill4time":{"serverUrl":"https://bill4time.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
8| Parameter | Type | Required | Description |
|---|---|---|---|
| id | integer | No | Only the record with this id. |
| top | integer | No | Records to return, 1-100 (default 25). |
| skip | integer | No | Records to skip (default 0). Pass the previous reply's next_skip to read the next page. |
| sort | enum | No | Field to sort by (default: Bill4Time's own order).id | clientName | creationDate |
| status | enum | No | Active | Disabled |
| descending | boolean | No | Sort descending (newest or highest first). Default ascending. |
| client_name | string | No | Exact client name (case rules are Bill4Time's). |
| created_after | string | No | Clients created on or after this date. |
| created_before | string | No | Clients created on or before this date. |
| include_custom_fields | boolean | No | Also return the custom fields (default false). |
Details
From the project READMEBill4Time MCP by usefulapi
Use Bill4Time from Claude, Cursor, or any MCP client — read clients, projects, time entries, expenses, invoices, payments, users and contacts with typed filters and sorting. Read-only; confidential fields such as addresses, tax ids and pay rates are never returned. Needs a Bill4Time v1 API key. Hosted, no local install: connect with your own Bill4Time credentials.
Live endpoint: https://bill4time.usefulapi.io/mcp · Homepage: https://usefulapi.io/bill4time
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://bill4time.usefulapi.io/mcp. - Claude Code:
claude mcp add --transport http bill4time https://bill4time.usefulapi.io/mcp, then run/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"bill4time": {
"url": "https://bill4time.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Bill4Time credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/bill4time/
Tools
| Tool | Type | What it does |
|---|---|---|
bill4time_list_clients | read | List clients |
bill4time_list_projects | read | List projects (matters) |
bill4time_list_time_entries | read | List time entries |
bill4time_list_expenses | read | List expenses |
bill4time_list_invoices | read | List invoices |
bill4time_list_payments | read | List payments |
bill4time_list_users | read | List users (timekeepers) |
bill4time_list_contacts | read | List contacts |
bill4time_usage_status | meta | Usage status (free-tier meter) |
bill4time_request_feature | meta | Request a missing feature |
bill4time_upgrade | meta | Upgrade to Pro (unlimited*) |
bill4time_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro (per API key) | $9/mo or $90/yr (2 months free) | Unlimited* |
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with bill4time_upgrade (it returns a Stripe Checkout link). Cancel any time with bill4time_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running bill4time_upgrade before then undoes the cancel. Or write to [email protected].
License
MIT © usefulapi. Not affiliated with or endorsed by Bill4Time.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.