> ## Documentation Index
> Fetch the complete documentation index at: https://developers.everhour.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Everhour in Claude

> Connect Everhour to Claude to start timers, log time, check your timesheet, and find tasks by asking in plain language.

Everhour in Claude lets you track time by asking for it. Start a timer, log an hour to yesterday, check what you tracked this week, or find the task you're about to work on — in the same conversation where you're already working, without opening Everhour.

Claude reads and writes your Everhour data as you, so it sees exactly what you'd see in the web app and nothing more.

<Frame caption="Ask for a timer and you get a running clock with a **Stop** button.">
  <img src="https://mintcdn.com/everhour/QlQ4heZDC9YJuCy-/images/mcp/claude-ui/timer-card.png?fit=max&auto=format&n=QlQ4heZDC9YJuCy-&q=85&s=850e7f1447b1bf416d27addedbd93076" alt="A Claude conversation. The prompt reads “Start a timer on Crash triage”. Claude calls the everhour_start_timer tool and returns an Everhour card: the task Crash triage in the project Mobile App v2, a tracking badge, a clock reading 00:00:28, and a red Stop timer button." width="1560" height="900" data-path="images/mcp/claude-ui/timer-card.png" />
</Frame>

## What you can ask for

* **Your timer** — start one on a task, start one without a task, stop it, or check what's running.
* **Your time** — log time to a task, fix a duration you got wrong, or clear an entry you put in the wrong place.
* **Your timesheet** — this week with daily totals, or any month of raw entries.
* **Your tasks** — search by keyword, see what you tracked recently, open one task in detail, or pin the ones you return to.
* **Your projects, clients, and team** — look up a project, a client, or who's on the team.
* **Team reports** — hours by project or member, project budgets, who's on time off, and weekly capacity, as far as your role allows.

## Set up Everhour in Claude

You need an active Everhour account. There's nothing to set up in Everhour first — no app to create and no key to copy, and nothing to pay: connecting an assistant is included in every Everhour plan at no extra cost.

Add Everhour as a custom connector, sign in when your browser opens, and switch it on in your chat. It works the same in Claude on the web, in the desktop app, and in the mobile apps.

<Note>
  **On a Team or Enterprise plan, only an Owner can add a connector.** If that's not you, you don't need to do the setup — ask your Owner to add Everhour once, then open **Customize → Connectors** and click **Connect**. On Free, Pro, and Max you add it yourself.
</Note>

<CardGroup cols={2}>
  <Card title="Claude on the web and desktop" icon="plug" href="/mcp-connect#claude-desktop">
    The setup, click by click — including what to do if you're not an admin.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/mcp-connect#claude-code">
    One command, then authorize in the browser.
  </Card>
</CardGroup>

To check it worked, ask *"What's my Everhour timesheet this week?"* A real answer means you're connected.

## Interactive cards

In Claude, some answers come back as a card you can actually use, not just text. Ask about your timer and you get a running clock with a **Stop** button. Ask for your tasks and you get a list where each row starts a timer.

There are four:

* **Timer** — the running task, elapsed time, and a **Stop** button. Appears when you ask what you're tracking, or when you start or stop a timer.
* **Task list** — recent tasks, search results, or your favorites. Every row has a start button and a chevron that opens the full task; rows in the favorites list also carry a star.
* **Task card** — one task with its project, assignees, estimate, status, tags, and your time on it. You can start the timer, add time, or star it without leaving the card.
* **Timesheet** — a month grid or a week list, switchable, with daily and weekly totals. In the month grid, click a day to see the entries behind it.

The task card, up close:

<Frame caption="Open a task from any row and you get its status, totals, and fields — plus **Start Timer** and **+** to add time without leaving the card.">
  <img src="https://mintcdn.com/everhour/QlQ4heZDC9YJuCy-/images/mcp/claude-ui/task-card.png?fit=max&auto=format&n=QlQ4heZDC9YJuCy-&q=85&s=2982d4fd9c97d30377715f4be74d6dfb" style={{ width: "64%" }} alt="The Everhour task card in Claude: the task Crash triage with a star, an Open status, 49 hours 7 minutes tracked against a 12-hour estimate, a row for the signed-in user with a Start Timer button and a plus button, and fields for assignee, due date, project, section, and tags." width="1028" height="724" data-path="images/mcp/claude-ui/task-card.png" />
</Frame>

The timesheet card in each of those states:

<Tabs>
  <Tab title="Month">
    <Frame caption="The month grid, with a figure for every day and a total for every week.">
      <img src="https://mintcdn.com/everhour/QlQ4heZDC9YJuCy-/images/mcp/claude-ui/timesheet-month.png?fit=max&auto=format&n=QlQ4heZDC9YJuCy-&q=85&s=cb6ada5f0e93b122a5e08211c2223ed6" alt="The Everhour timesheet card in Claude, month view: a July calendar grid with hours on each weekday, a totals column for each week, and a running header total of 108 hours 45 minutes." width="1582" height="1262" data-path="images/mcp/claude-ui/timesheet-month.png" />
    </Frame>
  </Tab>

  <Tab title="Week">
    <Frame caption="The same card switched to **Week** — weeks collapse, and each day breaks down by task.">
      <img src="https://mintcdn.com/everhour/QlQ4heZDC9YJuCy-/images/mcp/claude-ui/timesheet-week.png?fit=max&auto=format&n=QlQ4heZDC9YJuCy-&q=85&s=c2c0f8d616b67115c76a0aeee67ebed3" alt="The Everhour timesheet card in Claude, week view: a list of weeks with their totals, the current week expanded to show each day and the tasks tracked against it." width="1590" height="1706" data-path="images/mcp/claude-ui/timesheet-week.png" />
    </Frame>
  </Tab>

  <Tab title="One day">
    <Frame caption="Click a day in the month grid and the entries behind it open in place.">
      <img src="https://mintcdn.com/everhour/QlQ4heZDC9YJuCy-/images/mcp/claude-ui/timesheet-day.png?fit=max&auto=format&n=QlQ4heZDC9YJuCy-&q=85&s=c5eb90cb79735673c69494b508c35a3a" alt="The Everhour timesheet card in Claude with July 14 selected in the month grid, expanded to list the four tasks tracked that day with their durations and projects." width="1536" height="1448" data-path="images/mcp/claude-ui/timesheet-day.png" />
    </Frame>
  </Tab>
</Tabs>

The cards talk to Everhour directly, so a timer you stop in a card is stopped everywhere — the web app, the browser extension, the mobile apps.

<Note>
  Cards appear in the Claude apps that can draw them. Anywhere they can't, the same answer arrives as plain text with nothing left out.
</Note>

## Example prompts

Phrase things however you like — these are just starting points.

**Tracking right now**

* *"Start a timer on the login bug."*
* *"What am I tracking?"*
* *"Stop my timer."*
* *"Start a timer for the standup — I'm not on a task."*

**Filling in time**

* *"Log 2 hours to the API docs task."*
* *"I forgot to track yesterday — put 3 hours on the checkout redesign for Tuesday."*
* *"Change yesterday's design entry to 90 minutes."*
* *"I logged that to the wrong task, clear it."*

<Note>
  Clearing sets the time to zero rather than deleting the row — the task keeps a 0-hour line on your timesheet. To move the time somewhere else, ask Claude to change the entry to the right task instead of clearing it. [Why it works that way](/mcp-tools#time-records).
</Note>

**Looking back**

* *"Show my timesheet for this week."*
* *"How much did I track in April?"*
* *"Which project got most of my time last month?"*

**Finding work**

* *"Find tasks about onboarding."*
* *"What have I worked on recently?"*
* *"Track time on this Asana link."* (paste the URL)
* *"Pin the checkout task to my favorites."*

**Reporting on the team**

* *"How many hours did the team log by project last month?"*
* *"Which projects are over budget?"*
* *"Who's out on time off next week?"*

## Permissions and privacy

* **You approve the connection once.** Signing in happens on Everhour, in your browser. Claude never sees your password.
* **Claude acts as you, and only as you.** It can do exactly what your Everhour role allows — a member can't read the team's payroll through Claude any more than through the web app.
* **Claude asks before it changes anything.** The tools that write to your account are marked as such, and Claude prompts you to confirm each time.
* **Everhour doesn't see your conversation.** We receive the details of the actions Claude takes — a task, a duration, a date, a comment, a search term — and nothing else. What you type to Claude stays between you and Claude; it never reaches Everhour.

[Data, privacy, and permissions](/mcp-privacy) covers all of this in full, including how long Claude's access lasts and which links a card can open.

## If something isn't working

<AccordionGroup>
  <Accordion title="Claude says it can't find Everhour">
    Check that Everhour is switched on for this conversation — click **+** at the lower left of the chat box and look under **Connectors**. Connectors are enabled per chat, so one you added earlier may be off in a new conversation.
  </Accordion>

  <Accordion title="A report shows 0 where you expected money">
    That's a permissions boundary, not a figure. Cost and billing columns you're not allowed to see come back as `0` — see [Data, privacy, and permissions](/mcp-privacy#what-the-assistant-can-do).
  </Accordion>

  <Accordion title="Claude asks you to confirm every time">
    That's the *destructive* hint doing its job — the tools that change your data always prompt. The rest read only and run without asking. [Which ones](/mcp-privacy#actions-that-ask-before-they-run).
  </Accordion>
</AccordionGroup>

If signing in never finishes, Claude lists fewer tools than it should, or the connection needs resetting, see [Troubleshooting](/mcp-connect#troubleshooting). To disconnect Everhour entirely, see [Disconnecting](/mcp-connect#disconnecting).
