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 2

Add to ChatGPT

1In ChatGPT, enable Developer mode under Settings → Apps & Connectors.
2Click "Create" and add the MCP endpoint URL above with OAuth authentication.
3ChatGPT opens a ShellTime page — sign in and approve the access request.
4Done. Mention the ShellTime connector in a chat to query your data.

Step 3

Things you can ask

“Draw a chart of my Claude Code token usage per day over the last month”
“How many prompts did I send to AI tools each day over the last 30 days? Chart it and tell me my busiest day.”
“Find my AI coding sessions about the auth middleware and summarize what each one did.”
“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_dailyai_prompts_dailyai_usage_breakdownai_model_breakdownai_tool_usageai_sessions_searchai_sessions_listai_session_detailai_prompts_search

Editor activity

coding_activity_summarycoding_activity_statscoding_activity_breakdown

Across everything

activity_overview_daily

Account & hosts

user_profilelist_hosts

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' data.

Not tracking anything yet?

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

Install ShellTime