Connect ShellTime to your AI assistant

ShellTime ships a remote MCP (Model Context Protocol) server, so Claude, ChatGPT and other AI assistants can query your shell history, AI coding usage and editor activity — and draw charts from them — in natural language.

Step 1

MCP server endpoint

Add this URL as a remote MCP server in your AI client. Authentication uses OAuth: your client redirects you to ShellTime to sign in and approve read-only access.

https://api.shelltime.xyz/api/v3/mcp

Step 2

Add to Claude

1Open claude.ai and go to Settings → Connectors.
2Click "Add custom connector" and paste the MCP endpoint URL above.
3Claude opens a ShellTime page — sign in and approve the access request.
4Done. Ask Claude about your shell or AI coding activity in any chat.

Step 3

Things you can ask

“Draw a chart of my Claude Code token usage per day over the last month”
“What are my top 10 shell commands this week?”
“How much did my AI coding sessions cost per project in January?”
“Which languages did I spend the most time coding in recently?”

Reference

Available tools

All tools are read-only and return structured data. The daily and stats tools return complete time series, so your assistant can render charts directly.

Shell commands

search_commandstop_commandscommands_stats

AI coding

ai_usage_summaryai_usage_daily

Security & privacy

Access is granted through OAuth 2.1 with PKCE — you approve every connection on shelltime.xyz, and tokens are issued per client.
Tokens are read-only: connected assistants can never modify or delete your data.
A connection only ever sees your own data, never other users'.

Not tracking anything yet?

Install the ShellTime CLI first, then connect your assistant to query the data.

Install ShellTime