YOUR FOCUS, IN CONTEXT

Connect your
assistant.

Bring your focus history into the conversation.
Choose your assistant below to get started.

Get your server path

Open locktfin → Settings → Data & MCP and copy the Server path.

Server path

This is the standard Applications location. If yours differs, paste it here to update the instructions. The path stays in this browser.

Choose your assistant

Already connected as pomopo or locktfin? Keep that entry. Add these settings only if you need a new connection.

Claude DesktopLocal connection

In Claude Desktop, open Settings → Developer → Edit Config. On macOS, the file is ~/Library/Application Support/Claude/claude_desktop_config.json.
Merge the entry below into the file’s mcpServers object. Keep any servers already there.
Save, fully quit Claude Desktop, and reopen it. In a new chat, check that the locktfin tools are available.

{
  "mcpServers": {
    "locktfin": {
      "command": "/Applications/locktfin.app/Contents/MacOS/PomopoMCP",
      "args": []
    }
  }
}

Use the desktop app for this local connection. Adding a connector on claude.ai is a different setup. Claude Desktop setup reference ↗

Let an agent help with setup

Paste this into an assistant that can help configure your Mac, or use it to get guided manual steps.

Help me connect locktfin to Claude Desktop on my Mac.

The installed local stdio MCP executable is:
/Applications/locktfin.app/Contents/MacOS/PomopoMCP
It takes no arguments. Confirm the executable exists before using it.

Inspect this client’s existing MCP configuration. Merge the locktfin entry without replacing other settings. Preserve an existing pomopo or locktfin entry and its working command/allowlist instead of creating a duplicate.

If you cannot access local files or run commands, give me the manual steps; do not claim you configured it. Configure only the requested client. The four read-only tools are timer_status, sessions_list, sessions_get and settings_get. Verify initialization and tool discovery, then explain any required reconnect or restart. Do not start a timer or change app records to test it.

The helper reads local focus records, including goal and project names. My assistant provider may process the returned information.

ChatGPTSecure MCP Tunnel

ChatGPT reaches the local helper through OpenAI’s Secure MCP Tunnel. Your Mac and the tunnel need to stay running while you use the connection.

Check that your OpenAI account and ChatGPT workspace have MCP connector access and tunnel permissions. If these options are missing, ask your workspace admin.
With Homebrew installed, run the first two commands below. Follow the quickstart to create a tunnel for your ChatGPT workspace and configure its runtime credential locally. Keep API keys out of chat.
Replace YOUR_TUNNEL_ID below with your tunnel ID, then run the remaining commands. Continue only when the doctor reports the tunnel is ready; leave tunnel-client run running.
In ChatGPT’s app/connector settings, create a custom MCP connection using Tunnel mode and your tunnel ID. Discover the tools, enable the connection, and select it in a new chat.

brew install openai/tools/tunnel-client
tunnel-client help quickstart

tunnel-client init --sample sample_mcp_stdio_local \
  --profile locktfin \
  --tunnel-id YOUR_TUNNEL_ID \
  --mcp-command '/Applications/locktfin.app/Contents/MacOS/PomopoMCP'

tunnel-client doctor --profile locktfin --explain
tunnel-client run --profile locktfin

This route uses OpenAI’s tunnel client, which is installed separately. Account availability and setup can vary. Full OpenAI tunnel walkthrough ↗

Let an agent help with setup

Paste this into an assistant that can help configure your Mac, or use it to get guided manual steps.

Help me connect locktfin to ChatGPT through OpenAI Secure MCP Tunnel.

The installed local stdio MCP executable is:
/Applications/locktfin.app/Contents/MacOS/PomopoMCP
It takes no arguments. Confirm the executable exists before using it.

Use the official OpenAI tunnel-client with a local stdio binding. First help me check tunnel access, workspace permissions and connector availability. Guide me through creating a tunnel and configuring its runtime credential locally; never ask me to paste API keys into this chat. Keep the tunnel running while ChatGPT uses it. Use https://github.com/openai/tunnel-client/blob/master/docs/onboarding.md for the current setup.

If you cannot access local files or run commands, give me the manual steps; do not claim you configured it. Configure only the requested client. The four read-only tools are timer_status, sessions_list, sessions_get and settings_get. Verify initialization and tool discovery, then explain any required reconnect or restart. Do not start a timer or change app records to test it.

The helper reads local focus records, including goal and project names. My assistant provider may process the returned information.

Grok BuildLocal connection

Install and sign in to Grok Build on your Mac. This setup uses its grok command, rather than the Grok website.
Run grok mcp list in Terminal first. If there is no existing locktfin or pomopo entry, add the server with the command below.
Check the doctor result, then start Grok Build. Use /mcps to confirm that locktfin is enabled.

grok mcp add locktfin -- '/Applications/locktfin.app/Contents/MacOS/PomopoMCP'
grok mcp doctor locktfin

Grok Build setup reference ↗

Let an agent help with setup

Paste this into an assistant that can help configure your Mac, or use it to get guided manual steps.

Help me connect locktfin to Grok Build on my Mac.

The installed local stdio MCP executable is:
/Applications/locktfin.app/Contents/MacOS/PomopoMCP
It takes no arguments. Confirm the executable exists before using it.

Inspect this client’s existing MCP configuration. Merge the locktfin entry without replacing other settings. Preserve an existing pomopo or locktfin entry and its working command/allowlist instead of creating a duplicate.

If you cannot access local files or run commands, give me the manual steps; do not claim you configured it. Configure only the requested client. The four read-only tools are timer_status, sessions_list, sessions_get and settings_get. Verify initialization and tool discovery, then explain any required reconnect or restart. Do not start a timer or change app records to test it.

The helper reads local focus records, including goal and project names. My assistant provider may process the returned information.

CursorLocal connection

Open Cursor’s MCP settings, or open ~/.cursor/mcp.json on your Mac for a connection available across projects.
Merge the entry below into mcpServers. Keep your existing servers and other settings.
Save and enable locktfin in Cursor’s MCP settings. Reconnect the server if needed, then open an Agent chat.

{
  "mcpServers": {
    "locktfin": {
      "type": "stdio",
      "command": "/Applications/locktfin.app/Contents/MacOS/PomopoMCP",
      "args": []
    }
  }
}

Cursor setup reference ↗

Let an agent help with setup

Paste this into an assistant that can help configure your Mac, or use it to get guided manual steps.

Help me connect locktfin to Cursor on my Mac.

The installed local stdio MCP executable is:
/Applications/locktfin.app/Contents/MacOS/PomopoMCP
It takes no arguments. Confirm the executable exists before using it.

Inspect this client’s existing MCP configuration. Merge the locktfin entry without replacing other settings. Preserve an existing pomopo or locktfin entry and its working command/allowlist instead of creating a duplicate.

If you cannot access local files or run commands, give me the manual steps; do not claim you configured it. Configure only the requested client. The four read-only tools are timer_status, sessions_list, sessions_get and settings_get. Verify initialization and tool discovery, then explain any required reconnect or restart. Do not start a timer or change app records to test it.

The helper reads local focus records, including goal and project names. My assistant provider may process the returned information.

Try your first question

In a new conversation, enable locktfin and ask:

What did I focus on today? Use my locktfin session history, grouped by goal and project.

Your assistant should read locktfin’s records. No history yet? It should say so. In Settings → Data & MCP, Connected means a client has connected to the helper.

What can my assistant access?

The helper exposes four read-only tools:

timer_status — the current timer.
sessions_list — filtered session history.
sessions_get — one session record.
settings_get — non-sensitive timer preferences.

It cannot create goals, start or stop timers, edit records, or change settings. A read may reconcile a timer that has already elapsed under the app’s normal rules.

Your assistant may send the records it reads, including goal and project names, to its provider. Review that provider’s data policy and tool permissions.

My assistant cannot find locktfin

Check that the Server path matches the installed app and that Data & MCP shows Ready or Connected. Reconnect the MCP server or restart the assistant after saving its configuration; a new chat alone may not reload it.

For ChatGPT, keep the tunnel running and check its doctor output, workspace permissions and tunnel ID. For Grok Build, run grok mcp doctor locktfin. A working connection still needs tool access enabled in the conversation.

How do I disconnect?

Disable or remove the locktfin server in your assistant’s MCP settings. For ChatGPT, also stop the tunnel process. Your locktfin goals and history stay on your Mac, and the app keeps working on its own.

Need a hand? Talk to Nigel ↗