---
title: "Ask Claude About Your Day — xeve Now Has an MCP Server"
description: "Connect xeve to Claude Desktop or Claude Code via MCP and query your productivity, coding, health, music, and GitHub data conversationally. Open source, 9 tools, zero config."
date: "2026-03-21"
app: orma
category: "building-xeve"
readingTime: "5 min read"
---

<p>Dashboards are great for visual exploration. But sometimes you just want to ask: "How much did I code today?" or "Does my sleep affect my productivity?" and get an answer in plain text. That is what the xeve MCP server does.</p>

<h2>What Is MCP?</h2>

<p>The <strong>Model Context Protocol</strong> is an open standard by Anthropic that lets AI assistants connect to external data sources. Instead of pasting data into a chat window, you configure a server once and the AI can query it directly. Claude Desktop and Claude Code both support MCP natively.</p>

<p>The xeve MCP server exposes your personal analytics as 9 tools that Claude can call. You ask a question in natural language, Claude decides which tool to call, and your data comes back formatted and ready for analysis.</p>

<h2>The 9 Tools</h2>

<ul>
<li><strong>get_productivity_summary</strong> — total screen time, productive vs. distracted time, top categories, app switches</li>
<li><strong>get_app_usage</strong> — which apps you used, for how long, sorted by duration</li>
<li><strong>get_coding_summary</strong> — coding time by project and language</li>
<li><strong>get_health_summary</strong> — steps, active energy, sleep duration, heart rate from HealthKit</li>
<li><strong>get_music_history</strong> — Spotify tracks, top artists, total listening time</li>
<li><strong>get_github_activity</strong> — commits, PRs, reviews, lines changed, active repos</li>
<li><strong>get_correlations</strong> — statistical correlation between any two metrics (e.g., sleep vs. coding)</li>
<li><strong>get_daily_trend</strong> — day-by-day table of all metrics for spotting trends</li>
<li><strong>get_recent_sessions</strong> — your most recent app sessions with window titles</li>
</ul>

<p>Every tool accepts optional <code>from</code> and <code>to</code> date parameters. "This week", "last month", "yesterday" — Claude translates your natural language into the right dates.</p>

<h2>Setup: Two Minutes</h2>

<p>For Claude Desktop, add this to your config:</p>

<pre><code>{
  "mcpServers": {
    "xeve": {
      "command": "npx",
      "args": ["-y", "xeve-mcp-server"],
      "env": {
        "XEVE_ACCESS_TOKEN": "your-token"
      }
    }
  }
}</code></pre>

<p>For Claude Code:</p>

<pre><code>claude mcp add xeve -e XEVE_ACCESS_TOKEN=your-token -- npx -y xeve-mcp-server</code></pre>

<p>Get your access token from Settings → API Access on the xeve dashboard. That is it. No server to deploy, no Docker container, no configuration file.</p>

<h2>Example Conversations</h2>

<p><strong>"How productive was I this week compared to last week?"</strong></p>

<p>Claude calls <code>get_productivity_summary</code> twice — once for this week, once for last week — and compares the numbers. You get a plain-text comparison: screen time up 12%, productive percentage down 5%, coding time flat.</p>

<p><strong>"Does sleep affect my coding output?"</strong></p>

<p>Claude calls <code>get_correlations</code> with <code>sleep_ms</code> and <code>coding_ms</code>. You get the Pearson coefficient, sample size, and a plain-English interpretation: "Days with more sleep tend to have more coding time (moderate positive, r=0.52)."</p>

<p><strong>"What did I work on today?"</strong></p>

<p>Claude calls <code>get_recent_sessions</code> and <code>get_coding_summary</code>. You see your app timeline with window titles, plus a project-by-project coding breakdown.</p>

<h2>Architecture: Supabase RPC Over Stdio</h2>

<p>The MCP server is a lightweight Node.js process that communicates via stdio (standard input/output). It does not run an HTTP server — Claude launches it as a subprocess and exchanges JSON-RPC messages through pipes.</p>

<p>Under the hood, it uses your Supabase access token to call the same RPC functions the web dashboard uses: <code>get_app_usage_summary</code>, <code>get_coding_summary</code>, <code>compute_correlation</code>, and direct table queries for Spotify and GitHub data. Row-Level Security ensures you can only access your own data — the same security boundary as the dashboard.</p>

<h2>Open Source</h2>

<p>The MCP server is open source at <a href="https://github.com/xeveio/xeve-mcp-server">github.com/xeveio/xeve-mcp-server</a> and published on npm as <code>xeve-mcp-server</code>. It is 300 lines of TypeScript with two dependencies. Fork it, extend it, add your own tools.</p>