Connect MCP
Connect Grok Bot or Cursor to the same Portime workspace as the in-app assistant. Sign in, pick an organization, and start tracking time. You do not paste an API key.
Connect in one click
Grok Bot and Cursor sign you in on Portime. A new account finishes the normal Starter trial checkout, then you pick the organization.
Grok Bot
- Add a custom connector with the URL https://app.getportime.com/api/mcp.
- Sign in on Portime with Google, Microsoft, or email. New accounts complete Starter trial checkout.
- Pick the organization and allow access to read and write time data.
Cursor
- Add the Portime MCP server with the URL below. Cursor starts the sign-in for you.
- Sign in on Portime. New accounts complete Starter trial checkout before the organization list.
- Pick the organization and allow access.
Add the server, then sign in on Portime and pick the organization. You do not paste an API key.
URL
https://app.getportime.com/api/mcpExample requests
After you are connected, ask your client in plain language.
- Start a timer on project X.
- Log 2 hours yesterday on project X.
- Give me this week's time summary.
- List my recaps.
Requirements
MCP uses the same paid-organization access as the rest of Portime.
- An active paid plan for this organization.
- The organization must stay active. Subscription and membership are re-checked on every request.
Other clients
Claude and clients that do not use OAuth can still send a personal access token. Create it in Account, Security, then Personal access tokens.
x-api-key
x-api-key: pt_YOUR_TOKENAuthorization
Authorization: Bearer pt_YOUR_TOKENCreate a token in Account → Security → Personal access tokens, then replace pt_YOUR_TOKEN. Create a personal access token
Add to a client
Use official install links when available. Cursor signs you in. Other clients can still use a personal access token.
Add the server, then sign in on Portime and pick the organization. You do not paste an API key.
{
"mcpServers": {
"portime": {
"type": "streamable-http",
"url": "https://app.getportime.com/api/mcp"
}
}
}
This streamable HTTP entry has no API key. Cursor signs you in on Portime.
Mutating tools execute immediately once your AI client calls them.