# Life Dashboard

> Life Dashboard is an open-source MCP server for analytics and data. Read-only health and screen-time history from your self-hosted Life Dashboard Postgres. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, Linux
- **Repository:** https://github.com/owen282000/life-dashboard-stack/tree/HEAD/mcp
- **MCP Registry name:** io.github.owen282000/life-dashboard
- **Categories:** analytics and data, health and science
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/life-dashboard
