Skip to content
MCP server

UseHourly

Free time tracking with timers, timesheets, sign-off links and invoices for assistants

Install
Pricing
Open source
Platforms
Web, API, self-hosted
Runs
Locally or Remotely
Version
1.1.0
Listing updated
2 days ago

About UseHourly

UseHourly is an open-source MCP server for productivity. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://usehourly.app/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "usehourly": {
      "url": "https://usehourly.app/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • USEHOURLY_API_TOKENA token from UseHourly > Account > AI assistants (read-only or read and change, with an expiry). The bridge sends it to https://usehourly.app/api/mcp as a Bearer token.Required

What it does

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

Pricing

Open source

Free, MIT licensed; no ads

Prices change. Check usehourly.app before you buy.

UseHourly 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 to UseHourly

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  6. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity