Use Sumhour in Claude

The Sumhour connector lets Claude work in your Sumhour workspace: start and stop the timer, log and fix time entries, check and submit your week, add expenses, draft invoices, record payments and run reports. Claude acts as you, within your role and the permissions you approve, and asks before every change.

Connect

In Claude (claude.ai or the desktop app), open Customize → Connectors. Find Sumhour in the directory, or press + → Add custom connector and paste:

https://app.sumhour.com/mcp

Leave the OAuth fields under Advanced settings empty. Claude sends you to Sumhour to sign in. The approval page, “Allow Claude to use Sumhour?”, shows where the request came from, a Workspace picker (one connection covers one workspace) and the permissions Claude asks for as checkboxes. Untick anything you do not want to share, then press Allow.

On Team and Enterprise plans an owner adds the connector for the organization first. A self-hosted Sumhour uses its own address, for example https://time.youragency.com/mcp.

In Claude Code:

claude mcp add --transport http sumhour https://app.sumhour.com/mcp

Then run /mcp and choose Authenticate.

Things to ask

“Log 2 hours on the Field app project for yesterday, design review with the client.”
“What did I track this week, and is anything missing a note?”
“Start a timer on Launch site, task Design.” Later: “Stop my timer.”
“Draft an invoice for Fieldwork with everything uninvoiced up to 31 October.”
“Show me the profitability report for October by client.”
“Which timesheets are waiting for my approval? Approve Sam’s week.”
“Record a 1,500.00 bank transfer against INV-1041, paid on 3 November.”

Claude lists your projects before logging time, so it uses the right project and task. Dates and durations can be written the way you would say them.

What Claude can and cannot do

Claude sees only the tools your role allows. A member can track time, submit weeks and add expenses; billing tools appear for owners, admins and accountants; approval tools for managers and above. If you unticked a permission on the approval page, its tools are left out.

Reading (your timer, entries, projects, reports, invoices) happens without asking. Every change, from logging an entry to recording a payment, is shown to you in Claude for confirmation first. Deleting an entry asks too.

Claude cannot send an invoice to a client, move money or change who is in your workspace. It records payments you have already received; it does not take or send them. Locked weeks, required notes and approvals apply exactly as in the web app, and when Sumhour refuses something, Claude tells you why.

Every change Claude makes appears under Activity with your name and “via MCP · Claude”.

Disconnect

In Sumhour, open the user menu → API tokens → Connected apps and press Disconnect next to Claude. Access ends at once, including any session Claude has open. Owners and admins can disconnect anyone’s apps. You can also remove the connector in Claude’s own settings.

Troubleshooting

Claude says it is not connected or asks to sign in again. A connection renews itself while you use it. After 30 days without use, a disconnect in Sumhour or a removed workspace membership, Claude needs you to sign in again from Customize → Connectors.
A tool you expected is missing. Your role or the permissions you approved do not include it. Disconnect and connect again to tick more permissions, or ask an admin about your role.
“This week is locked” or “a note is required”. Sumhour’s workspace rules apply to Claude as they do to you. Unlock the week (managers) or add the note.
The wrong workspace. One connection covers one workspace. Disconnect and connect again, choosing the other workspace on the approval page.
A self-hosted server does not connect. Its address must be reachable over HTTPS from the internet; Claude connects from Anthropic’s servers, not from your computer.

Privacy

Claude reads only what a tool returns for your request, and only within the permissions you approved. Sumhour does not read your Claude conversations. Anthropic handles your prompts under your agreement with them. What Sumhour stores and why is in the privacy policy. Questions: [email protected].

More on API tokens, the command line tool and the assistant inside Sumhour: AI and agents. Technical reference: MCP guide.