@studioraming/hive-mcp

MCP server for AI dev session logs, development plans, and semantic search. Built on Supabase pgvector.

Features

• 17 MCP tools — Session tracking, Plan management, Index, Team management
• Browser auth — hive-mcp login opens browser, no passwords in env vars
• Auto project detection — Detects project from git remote or folder name
• Multi-team — Per-project team mapping, runtime switching
• Semantic search — Hybrid vector + full-text search with RRF fusion via pgvector
• Multi-agent — Works with Claude Code, Codex CLI, Gemini CLI, Cursor
• Auto-embedding — Automatically embeds session logs and plans (server-side, no API keys needed)

Quick Setup

1. Install

npm install -g hive-mcp-server

2. Login (one-time)

hive-mcp login

This opens your browser for Hive authentication, then lets you select a team in your terminal. Credentials are saved to ~/.hive-mcp/config.json.

3. Configure Claude Code

Add to your project's .claude/mcp.json:

{
  "mcpServers": {
    "hive": {
      "command": "hive-mcp"
    }
  }
}

That's it! No env vars needed. The server auto-detects your project and team.

Or use npx (no install)

{
  "mcpServers": {
    "hive": {
      "command": "npx",
      "args": ["-y", "hive-mcp-server"]
    }
  }
}

CLI Commands

| Command | Description | | ----------------- | ----------------------------------------------------------------------------- | | hive-mcp login | Browser auth + team selection | | hive-mcp logout | Clear saved credentials | | hive-mcp team | Re-select team for current project | | hive-mcp status | Show login/team/project status | | hive-mcp wrapup | Auto-upload a completed session (works with or without .session-summary.md) | | hive-mcp | Start MCP server (called by Claude Code) |

hive-mcp login auto-configures auto-wrapup for common clients:

• hive-mcp wrapup --agent claude
• Claude: adds Stop hook in ~/.claude/settings.json
• Codex: wraps notify in ~/.codex/config.toml and auto-calls wrapup once per diff-hash
• This sends session logs to Hive automatically after normal work, without manual session-log writing.

Legacy Setup (env vars)

For backward compatibility, you can still use environment variables:

{
  "mcpServers": {
    "hive": {
      "command": "hive-mcp",
      "env": {
        "HIVE_EMAIL": "[email protected]",
        "HIVE_PASSWORD": "your-password"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | | ----------------- | -------- | --------------------------- | | HIVE_EMAIL | No* | Your Hive account email | | HIVE_PASSWORD | No* | Your Hive account password | | HIVE_TEAM_ID | No | Team UUID override | | HIVE_PROJECT_ID | No | Project identifier override |

* Required only if not using hive-mcp login.

How It Works

1. Login: hive-mcp login opens browser → authenticate → select team → save tokens
2. Auto-detect: MCP server starts → detects project from git remote → maps to saved team
3. Session auth: Restores Supabase session from saved tokens (auto-refreshes)
4. Multi-project: Different projects can map to different teams automatically

Team Resolution Priority

1. config.projects[projectId].teamId — per-project mapping
2. config.defaultTeamId — default team
3. HIVE_TEAM_ID env var — legacy override
4. Auto-select first team

Database Setup

Apply the migrations to your Supabase project:

• supabase/migrations/013_dev_logs_semantic.sql — Tables, RPCs, indexes
• supabase/migrations/014_mcp_auth_grants.sql — Auth grants for user JWT

See the Hive repo for details.

Tools

Session Tools (6)

| Tool | Description | | ---------------- | ---------------------------------------------- | | session_start | Start a new dev session (auto-seq, auto-embed) | | session_log | Append steps and files to an active session | | session_end | End session with result, embed full summary | | session_list | List recent sessions | | session_read | Read session by ID or seq number | | session_search | Semantic + full-text hybrid search |

Plan Tools (6)

| Tool | Description | | -------------- | -------------------------------------------- | | plan_create | Create a 3-doc plan (plan/context/checklist) | | plan_update | Update a specific document | | plan_read | Read plan docs | | plan_list | List plans with progress stats | | plan_check | Toggle checklist items | | plan_archive | Archive or delete a plan |

Index Tools (2)

| Tool | Description | | --------------- | -------------------------------------- | | index_read | Session index (like .session-index.md) | | index_current | Current active session |

Team Tools (3)

| Tool | Description | | -------------- | -------------------------------------------- | | team_list | List teams with current team highlighted | | team_switch | Switch team (in-memory or persist to config) | | project_info | Show current project/team/auth status |

License

MIT