Skip to content
MCP server

Life Dashboard

Read-only health and screen-time history from your self-hosted Life Dashboard Postgres

Runs locallyStatus and history
Pricing
Open source
Platforms
self-hosted, CLI, Linux
Runs
Locally
Version
1.2.1
Listing updated
2 days ago

About Life Dashboard

Life Dashboard is an open-source MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

This server sits on the optional MCP part of the Life Dashboard Stack, a self-hosted backend that receives signed data from the Life Dashboard companion apps on Android and iPhone. Those apps push Health Connect or Apple Health records and per-app screen time to a receiver, which stores them in a single Postgres table that plain SQL views turn into days, nights, hours and apps.

The MCP server connects to that database as dash_ro, a user limited to reading the dash views, and offers eight read-only tools. The README gives the example question of whether you slept better in the weeks you walked more. With a local model such as one in Ollama, nothing leaves your machine.

It ships as a container image on ghcr.io and is configured with Postgres host, database, user and password variables. Over streamable HTTP the stack runs it itself behind a bearer token, and it stays off until a token is set. The author describes the project as a one-person effort offered as-is.

Install

Run in a terminal

claude mcp add life-dashboard --env PGHOST='<PGHOST>' --env PGDATABASE='<PGDATABASE>' --env PGUSER='<PGUSER>' --env PGPASSWORD='<PGPASSWORD>' -- docker run -i --rm -e PGHOST -e PGDATABASE -e PGUSER -e PGPASSWORD ghcr.io/owen282000/life-dashboard-mcp:1.2.1

Add to claude_desktop_config.json

{
  "mcpServers": {
    "life-dashboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PGHOST",
        "-e",
        "PGDATABASE",
        "-e",
        "PGUSER",
        "-e",
        "PGPASSWORD",
        "ghcr.io/owen282000/life-dashboard-mcp:1.2.1"
      ],
      "env": {
        "PGHOST": "<PGHOST>",
        "PGDATABASE": "<PGDATABASE>",
        "PGUSER": "<PGUSER>",
        "PGPASSWORD": "<PGPASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "life-dashboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PGHOST",
        "-e",
        "PGDATABASE",
        "-e",
        "PGUSER",
        "-e",
        "PGPASSWORD",
        "ghcr.io/owen282000/life-dashboard-mcp:1.2.1"
      ],
      "env": {
        "PGHOST": "<PGHOST>",
        "PGDATABASE": "<PGDATABASE>",
        "PGUSER": "<PGUSER>",
        "PGPASSWORD": "<PGPASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "life-dashboard": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PGHOST",
        "-e",
        "PGDATABASE",
        "-e",
        "PGUSER",
        "-e",
        "PGPASSWORD",
        "ghcr.io/owen282000/life-dashboard-mcp:1.2.1"
      ],
      "env": {
        "PGHOST": "<PGHOST>",
        "PGDATABASE": "<PGDATABASE>",
        "PGUSER": "<PGUSER>",
        "PGPASSWORD": "<PGPASSWORD>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "life-dashboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PGHOST",
        "-e",
        "PGDATABASE",
        "-e",
        "PGUSER",
        "-e",
        "PGPASSWORD",
        "ghcr.io/owen282000/life-dashboard-mcp:1.2.1"
      ],
      "env": {
        "PGHOST": "<PGHOST>",
        "PGDATABASE": "<PGDATABASE>",
        "PGUSER": "<PGUSER>",
        "PGPASSWORD": "<PGPASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "life-dashboard": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PGHOST",
        "-e",
        "PGDATABASE",
        "-e",
        "PGUSER",
        "-e",
        "PGPASSWORD",
        "ghcr.io/owen282000/life-dashboard-mcp:1.2.1"
      ],
      "env": {
        "PGHOST": "<PGHOST>",
        "PGDATABASE": "<PGDATABASE>",
        "PGUSER": "<PGUSER>",
        "PGPASSWORD": "<PGPASSWORD>"
      }
    }
  }
}

Configuration

  • MCP_TRANSPORTServes MCP on stdio. Over Streamable HTTP, with a bearer token, the stack runs it itself: see docs/mcp.md.
  • PGHOSTThe stack's Postgres: db on the stack's Docker network.Required
  • PGDATABASEThe stack's database.Required
  • PGUSERdash_ro, the stack's user that can only read the dash views.Required
  • PGPASSWORDThe password of dash_ro: DASH_DB_PASSWORD in the stack's .env.Required

What it does

Read-only database user
Connects as a Postgres user that can only select from the dash views.
Eight query tools
Exposes the stack's health and screen-time views to an AI client.
Local-model friendly
Works with Claude or a local model, so data can stay on your own machine.
Stdio or HTTP
Runs over stdio from the container, or over streamable HTTP with a bearer token inside the stack.
Multi-phone history
Android phones and iPhones sharing one stack appear as separate phones.

Good for

  • Ask whether sleep improved in weeks with more walking
  • Review screen time per app over a month
  • Summarise heart and activity trends from your own records
  • Answer health questions with a local model without sending data to a cloud

Pricing

Open source

Self-hosted and free; the Android companion app is a one-time purchase on Google Play and free from GitHub or F-Droid.

Life Dashboard FAQ

Where does the data live?

In your own Postgres, filled by the Life Dashboard companion apps through a signed webhook receiver.

Can the server change my data?

No. It uses a read-only database user and exposes read-only tools.

How is it installed?

As the OCI image ghcr.io/owen282000/life-dashboard-mcp, or as an optional part of the stack's Docker Compose or Helm setup.

Is it on by default?

No. Over HTTP it stays off until you set a token.

Is Life Dashboard free?

Yes. Life Dashboard is open source, so you can use and self-host it for free.

How do I add Life Dashboard to Claude Code?

Run this command in your terminal: claude mcp add life-dashboard --env PGHOST='<PGHOST>' --env PGDATABASE='<PGDATABASE>' --env PGUSER='<PGUSER>' --env PGPASSWORD='<PGPASSWORD>' -- docker run -i --rm -e PGHOST -e PGDATABASE -e PGUSER -e PGPASSWORD ghcr.io/owen282000/life-dashboard-mcp:1.2.1

What are the best alternatives to Life Dashboard?

The closest alternatives to Life Dashboard are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tooluniverse, Oya Browser and Tapetide - Indian Stock Market MCP.

Alternatives to Life Dashboard

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  4. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation
  5. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  6. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data