Connecting Your Agent
Connect a coding agent to AbleTime MCP so it can record draft time and create tasks as you. Reference detail lives under Documentation → Agentic AI; this guide is the first-connection path.
You need an organization where an admin or owner can enable agent access, plus a personal access token of your own.
1. Enable agent access
Have your administrator go to Settings → Integrations → API Keys.
Then switch Agent access (MCP) to Enabled so personal access tokens can call MCP. See Documentation → Integrations → API Keys and Documentation → Agentic AI → Connecting Your Agent.
2. Create your personal access token
You to open your profile settings and navigate to the API Access tab to create a token. Copy the secret immediately — AbleTime shows it once and never again.
For how personal tokens differ from organization API keys, see the Personal Access Tokens guide.
3. Configure the host
In your agent host (for example Cursor), add AbleTime as an MCP server. There are two endpoints. The core time / task endpoint posts to:
POST https://track.abletime.com/api/public/v2/mcp
The "project management" endpoint posts to:
POST https://track.abletime.com/api/public/v2/mcp/pm
They are separate both to reduce the amount of context consumed (~ 7k each) and to simplify the interactions. If you won't be assigning tasks, changing priorities etc. then the "PM" endpoint doesn't need to be registered at all.
Use the full URL, and send header Authorization: Bearer <your personal access token>.
AbleTime MCP accepts a JSON-RPC request as a single POST and returns one JSON response. Your host application (Claude.ai, Cursor, etc.) should already be configured for that by default.
4. First orientation
When you start a session, the agent calls orientation first. It should see your identity, open drafts, active tasks, and AbleTime's recording rules come back, and be immediately ready to support you.
If orientation fails with agent access disabled, return to step 1. If it fails with an invalid token, rotate or recreate the token in API Access.
5. Your first draft entry
We suggest you orient yourself with AbleTime MCP by testing one its core features: automated time/task tracking in the background.
You can do this by asking your Agent to confirm it can "see" AbleTime. If it hasn't already asked to track time for your session, ask it create a time entry and task within a project of your choice, just to confirm everything is working as expected. These should appear inside your AbleTime account within the Time Tracker and/or Time Flow sections (you may have to refresh the page).
6. Permissions
Depending upon your configuration, you may see permission prompts whenever it connects. This is a standard procedure when an Agent connects to anything outside it's normal environment. Your chat or IDE documentation shoul
7. Accept in AbleTime
All time entries created by Agents are 'drafts' and invisible to anyone but you. They do not appear in reports, billing or even your dashboards until you 'accept' them.
Open AbleTime, go to the Time Tracker section and you will see any outstanding drafts. You can either accept them individually, or open the Productivity Drawer "Accept" panel by clicking on the clipboard icon on the far-right margin. This panel lets you quickly accept and/or dismiss groups of drafts at once.
8. Customization
You can customize how your Agent records your Time Entries and Tasks through prompts. You can tell it things like "Always include the Task reference in the Time Entry body", or "Always put meeting time entries in the Meetings Internal category" and it will store this for future reference.
Next: Documentation → Agentic AI → Tips for afk and review habits; Documentation → Agentic AI → Customizing Behavior for working-document defaults. Endpoint detail: API Reference.