Toggl

Toggl logo
Log hours across devices with reporting and billing features for freelancers, agencies and teams.

Toggl API

Sign in
API key. API key; API access on: FreeSource

MCP server

What it is
Official local package @togglhq/mcp run via npx; no fixed remote endpoint (the draft's docs page is not a server URL).

Checked on 2026-10-10 in the developer documentation.

How to use Toggl

This guide gets you from a blank Toggl account to a time-tracking habit that actually tells you where your hours go, and a reporting setup you trust enough to bill from or to plan from. It is written for founders, consultants, and small teams who want honest data on their own time without turning tracking into a second job. If you have tried time tracking before and quietly abandoned it after two weeks, this is the version that sticks, because it is built around the workflows that survive a busy day rather than the ones that look tidy in a demo.

Getting set up

The decisions that matter in Toggl happen before you track a single minute, so spend ten focused minutes on structure rather than tracking randomly and reorganising later. Start by deciding what a "project" means to you. The most useful rule is that a project maps to a unit you would want to see a total against: a client, a venture, an internal initiative. Resist the urge to make a project per task, because tasks are a level below projects and that is where granularity belongs.

Read the full guide

Next, set up your workspace around how you actually report. If you bill clients, group projects under the clients they belong to so your billable totals roll up cleanly. If you run several ventures of your own, treat each venture as a client-equivalent so a portfolio view falls out naturally. Decide early whether a project is billable or internal, and whether it carries a rate, because retrofitting rates across months of historical entries is tedious and error-prone.

Build a small, deliberate set of tags before you start, not after. Tags are the cross-cutting dimension that projects cannot capture: the type of work (deep work, admin, meetings, sales), the channel, or the phase. Keep the tag list short enough to remember, because a tag you have to hunt for is a tag you will skip. Finally, install the desktop app and the browser extension on day one. Tracking from the web app alone is the single biggest reason people drift off, because the friction of switching tabs to start a timer is exactly the friction that kills the habit.

How to actually use it

The core loop is simple: start a timer when you start a thing, stop it when you stop, and label it well enough that future-you understands it. Do them in that order and do not over-think the labelling in the moment, because a roughly-labelled entry beats an untracked hour every time.

Begin each working block by starting a timer and assigning it to a project immediately, since an unassigned entry is the one you will struggle to place later. Write the description as a real sentence about what you are doing, not a code, because Toggl groups identical descriptions and clean descriptions make your reports readable. When you switch context, stop the current timer and start the next one rather than letting a single entry sprawl across three unrelated activities.

Once a day, do a sixty-second review of your entries: fix the mislabelled ones, split anything that ran too long across two tasks, and add the tag you forgot in the moment. This daily tidy is what makes the weekly report trustworthy. Then once a week, open the summary report, look at the split across projects and tags, and ask the only question that matters: did my time go where my priorities were. That comparison, repeated weekly, is the entire value of the tool.

Power moves

The first power move is idle detection and reminders. Toggl can notice when you have left your machine and prompt you to discard or keep the idle time, and it can nudge you when you have been tracking nothing for a while. Turn both on, because they fix the two failure modes (forgetting to stop, and forgetting to start) without any discipline from you.

The second is saved reports and rounding. If you bill from your data, save the exact report configuration you invoice from so you regenerate it identically each period, and set your rounding rule once so every invoice is consistent. The third is using the start-from-previous behaviour: continuing a recent entry with one click is far faster than retyping the project and description, and speed is what protects the habit.

The fourth, and the one that separates a pro, is treating your tracked data as a planning input rather than a billing record. When you can see that "sales" was a third of last week and you intended it to be a tenth, you change next week's calendar, not just your invoice. The pros close that loop; beginners only ever look backwards.

Where it fits your stack

Toggl sits at the measurement layer of a growth and operations stack, so it is most valuable when its data flows into the places you already make decisions. Connect it to your project or task tool so a tracked entry can be tied back to the work item it belongs to, which removes the double-entry of describing the same task twice. Wire it into your calendar so meetings can become tracked time without manual typing, since meetings are the hours people most often fail to record.

For billing, export to your invoicing or accounting tool rather than retyping totals, and for reporting, pull the summary into whatever dashboard you run your week from. If you live in automation tooling, Toggl's integrations and API let you push entries or pull totals programmatically, which is how you turn time data into a metric that updates itself instead of a spreadsheet you maintain by hand. The principle across all of it: Toggl should feed your decisions, not become another place you have to visit.

Pitfalls to avoid

The biggest pitfall is over-structuring on day one: a hundred projects and forty tags look thorough and then nobody tracks against them, because the overhead of choosing the right bucket exceeds the value. Start lean and add structure only when you feel the lack of it. The second is tracking only billable work, which gives you a beautiful invoice and a blind spot, since the internal and admin time you do not track is exactly the time that quietly eats your week.

The third is letting entries run unattended, so a single timer captures lunch, a meeting, and an afternoon as one blob. Idle detection and the daily tidy both guard against this. The fourth is collecting the data and never reading it, which is the most common failure of all: the report exists to change next week's behaviour, and an unread report is just guilt with a timestamp. The fix is to make the weekly review a fixed appointment, not a someday intention.

How to automate Toggl

Native integrations

Install the browser extension to track time inside the tools you already use, and use the native integrations for Asana, Jira, GitHub, Notion and Slack. A simple start: connect your calendar so meetings appear as suggested entries, then confirm them at the end of the day.

API and webhooks

Toggl publishes API documentation for developers. Use it to pull tracked hours into your invoicing tool each week, or to push a project's budget into a dashboard. The command line tool reaches the same API from a terminal, which suits scripts.

MCP server

Toggl has an official MCP server, described by the vendor as working with Claude, Cursor and Codex. Connect Claude and ask which projects went over estimate last month, or have it log time and create projects. It follows your plan and your role, so it can only do what you can do in the app.

No-code automation

Toggl lists automation apps on its integrations page. Use one to log a time entry when a task is closed in your project tool, so the hours are recorded without a second step.