# UseHourly

> UseHourly is an open-source MCP server for productivity. Free time tracking with timers, timesheets, sign-off links and invoices for assistants. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, self-hosted
- **Website:** https://usehourly.app
- **Repository:** https://github.com/zontak-llc/usehourly
- **MCP Registry name:** app.usehourly/usehourly
- **Categories:** productivity, finance and payments
- **Listing updated:** 2026-11-14

## About

An assistant here acts as you, with a token you create under Account, AI assistants that is either read-only or read and change, and carries an expiry. The README says the remote server has 32 tools across projects, clients, time entries, timers, timesheets, invoices and reports, and each runs with your own permissions so only your data is visible.

The underlying app is a freelancer tracker where you type `1.5`, `1:30` or `90m` and press Enter. It adds a weekly editable timesheet grid, a month calendar, PDF invoices with paid and unpaid tracking, a year summary by quarter and month for an accountant, and Excel export. Toggl and Clockify CSV exports can be imported, and the same file twice adds nothing. A sample-data demo account is deleted after a day.

It is MIT licensed, free with no paywall or ads, and the owner pays for the servers. For clients that only run local servers such as Claude Desktop, an npm bridge, `usehourly-mcp`, reads `USEHOURLY_API_TOKEN`.

## Features

- **32 assistant tools:** Projects, clients, entries, timers, timesheets, invoices and reports.
- **Scoped tokens:** Read-only or read-and-change tokens with an expiry.
- **Sign-off links:** Assistants can create a private link for a client to review a timesheet.
- **Invoices and year summary:** PDF invoices plus quarterly and monthly totals.
- **Quick entry:** Type 1.5, 1:30 or 90m and press Enter.
- **Toggl and Clockify import:** Bring in CSV exports without duplicates.

## Good for

- Log hours by telling an assistant
- Build a client's weekly timesheet
- Prepare a monthly invoice
- Fill gaps in a week's entries
- Switch from Toggl or Clockify

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http usehourly https://usehourly.app/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://usehourly.app/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "usehourly": {
      "url": "https://usehourly.app/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "usehourly": {
      "type": "http",
      "url": "https://usehourly.app/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "usehourly": {
      "serverUrl": "https://usehourly.app/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "usehourly": {
      "type": "http",
      "url": "https://usehourly.app/api/mcp"
    }
  }
}
```

## FAQ

### Is it really free?

The site says so: no paywall and no ads, and it is MIT licensed.

### How does Claude Desktop connect?

Through the usehourly-mcp npm bridge with an API token.

### Can an assistant change my data?

Only if the token you create allows read and change; read-only tokens are available.

### Can I self-host?

The README includes steps to run it locally and on Cloudflare Workers.

### Is UseHourly free?

Yes. UseHourly is open source, so you can use and self-host it for free.

### How do I add UseHourly to Claude Code?

Run this command in your terminal: claude mcp add --transport http usehourly https://usehourly.app/api/mcp

### What are the best alternatives to UseHourly?

The closest alternatives to UseHourly are Ha MCP, Concord MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and Budget Tracker.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/usehourly
