DoneThat MCP Server
Connect Claude, ChatGPT, and other MCP clients to your DoneThat work history with OAuth 2.1.
DoneThat is a time tracker that automatically turns captured work into tasks. A task is work already done, never a future to-do.
The DoneThat MCP server lets AI assistants read your tracked time and update your projects and tasks on your behalf. Connect with OAuth 2.1 using your existing DoneThat account. Leave any client ID and secret blank in the connector setup.
https://mcp.donethat.aiThe server uses Streamable HTTP transport at / and runs in stateless mode (no persistent MCP session required). Check availability at /health.
Connect in Claude
- Open Settings → Connectors.
- Choose Add custom connector.
- Paste the server URL:
https://mcp.donethat.ai - Complete the OAuth sign-in flow with your DoneThat account when prompted.
- Grant the scopes the connector requests.
Connect in ChatGPT
- Open Settings → Connectors (or the Apps/connectors area in your ChatGPT plan).
- Add a custom MCP server and paste
https://mcp.donethat.ai. - Sign in with your DoneThat account when OAuth opens.
- Approve the requested scopes.
ChatGPT may render report results in an embedded DoneThat widget.
Connect in Cursor or VS Code
Add an MCP server entry that points at the DoneThat URL. Exact UI labels vary by client; the server URL is always:
{
"mcpServers": {
"donethat": {
"url": "https://mcp.donethat.ai"
}
}
}
Your client discovers OAuth endpoints automatically. Sign in with DoneThat when prompted.
Auto-connect for Claude organizations
On Claude Team and Enterprise, an organization can connect its members without each of them signing in. Members are matched to DoneThat by verified email, and each member's Claude reaches only that member's data.
- In Claude, open Organization settings → Connectors and choose Set up auto-connect, then Claude-issued. Add the connector with Use Claude's published identity, not a client ID.
- Copy the Issuer URL from Claude.
- In DoneThat, open Organization → Auto-connect, paste the Issuer URL and turn it on. Only organization admins can do this.
- Copy the Tenant ID from DoneThat into Claude's setup. Claude marks it optional, but without it auto-connect stops working if another organization enters the same Issuer URL.
- Click Run test in Claude.
Members need a verified email and an active seat in the organization. Auto-connect never creates accounts or takes seats. Turning it off ends access straight away.
Authentication
DoneThat MCP uses OAuth 2.1 (authorization code with PKCE). You authenticate with your DoneThat account; the MCP host stores tokens on your behalf.
AI apps sign in with OAuth, so don't paste API keys into their connector settings.
Your own scripts can skip OAuth and send a DoneThat API key as Authorization: Bearer <key>. A key reaches only what its own scopes allow.
Sign-in flow
When a connector starts OAuth, the MCP server sends you to the DoneThat web app at https://app.donethat.ai:
- Sign in with Google or email and password (the same login you use for DoneThat).
- Review the requested scopes on the consent screen.
- Click Authorize to grant access.
- The connector receives an access token and refresh token and can call MCP tools on your behalf.
No client secret is required. Connectors use a public OAuth client with PKCE.
Discovery and OAuth endpoints on the MCP host:
| Endpoint | Purpose |
|---|---|
GET /.well-known/oauth-protected-resource | Protected resource metadata (RFC 9728) |
GET /.well-known/oauth-authorization-server | Authorization server metadata (RFC 8414) |
GET /.well-known/openid-configuration | Same metadata for OIDC discovery clients |
GET /oauth/scopes | Human-readable scope list |
POST /oauth/register | Dynamic client registration |
GET /oauth/authorize | Authorization (browser sign-in) |
POST /oauth/token | Token exchange and refresh |
POST /oauth/revoke | End access for a token (RFC 7009) |
Access tokens last an hour. Refresh tokens allow renewal without signing in again until they expire or are revoked.
Tools
| Tool | Description | Required scope(s) | Access |
|---|---|---|---|
generate_report | List tracked time for a date range as rows by activity, day, task, or week. Large reports come in pages. | reports:read | Read |
query_stats | Answer how tracked time splits or changed, by category, project, weekday and more. | reports:read | Read |
search_content | Find tasks and activity matching search text, over the last days or a dated window of up to 30 days. | search:read | Read |
list_projects | List your projects and their exact IDs. | projects:read or projects:write | Read |
manage_project | Create a project or update its name, description, or color. Merging projects is app-only. | projects:write | Write |
reassign_task_to_project | Move an already-recorded task to a different project, or unassign it. | projects:write | Write |
add_manual_task | Record uncaptured work with a start and end time. | tasks:write | Write |
submit_feedback | Send bug reports, product feedback, or feature requests to DoneThat support. | feedback:write | Write |
Daily summaries aren't available over MCP. Read, generate, approve, and edit them in the DoneThat app.
Large reports
generate_report returns a page of rows at a time. A paged response has totalRowCount, offset, and, unless it's the last page, nextOffset; call again with offset set to it. Use limit to set the most rows per page (up to 500), and detail: "concise" to leave out description text and empty fields.
Scopes
When you authorize a connector, DoneThat shows these OAuth scopes. Grant only what the integration needs.
| Scope | Grants |
|---|---|
reports:read | Generate DoneThat reports for the authenticated account, including activity, day, task, and week views. |
search:read | Search the authenticated user's task and activity history in read-only mode. |
projects:read | List the authenticated user's projects, including their IDs, names, descriptions, and colors. |
tasks:write | Create manual DoneThat tasks with a start and end time. |
projects:write | Create and rename projects, and change which project a recorded task is attributed to. |
feedback:write | Send product feedback, bug reports, or feature requests to the DoneThat support team. |
These scopes differ from HTTP API key scopes documented in the API reference.
Data and privacy
The MCP server acts on behalf of your DoneThat account. Depending on granted scopes, it may:
- Read aggregated activity and report rows
- Search task and activity history
- List, create, and update projects, and move tasks between them
- Create manual tasks
- Submit feedback to DoneThat support
DoneThat does not sell your data. See Privacy, Terms, and Data handling for how we collect, use, and protect information.
Rate limits and troubleshooting
Requests are rate limited per account. If a tool call fails with a rate-limit error, wait and retry.
Authentication errors: Confirm you completed OAuth sign-in and approved the scopes the tool needs. Disconnect and reconnect the connector if tokens expired without refresh. MCP needs a plan that includes it, so it stops when a trial ends.
Invalid dates: Pass dates as ISO strings (for example 2026-03-23).
Group reports: teamIds works at day, task, or week level, not activity level.
Support
Questions about MCP setup, OAuth, or tool behavior: Contact support.
For programmatic HTTP access (API keys), see the API reference.