Package Exports

@briefhq/mcp-server
@briefhq/mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@briefhq/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Brief MCP Server

This package contains the Brief MCP JSON-RPC server and a small CLI.

Install

Quick run (no install):

# Status check (no auth needed for dev)
npx -y @briefhq/mcp-server brief-mcp status --api-base https://api.briefhq.ai

# Device login (recommended)
BRIEF_AUTH_BASE=https://auth.briefhq.ai \
  npx -y @briefhq/mcp-server brief-mcp login

Global install (optional):

npm i -g @briefhq/mcp-server
BRIEF_AUTH_BASE=https://auth.briefhq.ai brief-mcp login
brief-mcp status --api-base https://api.briefhq.ai

Auth

Device flow (recommended):

brief-mcp login
# follows OAuth 2.0 Device Code flow; opens browser, saves token locally

Service key (direct):

brief-mcp login --token YOUR_API_KEY

Warning: Do not paste long‑lived service tokens into IDE config or checked‑in files. Prefer environment variables or a local .env; use rotating/ephemeral tokens when available, and rotate/revoke keys if accidentally exposed.

CLI

brief-mcp status: prints effective config and pings /v1/discover, surfacing request id when available.

Flags:

--api-base <url>
--workspace <id>
--token <token>
--timeout-ms <n>
--max-retries <n>
--log-level <debug|info|warn|error>
--config <file>

Config locations:

macOS: ~/Library/Application Support/Brief/mcp.json, ~/.config/brief/mcp.json
Linux: $XDG_CONFIG_HOME/brief/mcp.json, ~/.config/brief/mcp.json
Windows: %APPDATA%/Brief/mcp.json

Dev vs Prod headers

Production: workspace is derived from the token; x-brief-workspace-id is not required.
Development: you can pass --workspace <id> (or BRIEF_WORKSPACE_ID) to override.

IDE MCP client configuration

Use the installed binary:

{
  "mcpServers": {
    "brief": {
      "command": "brief-mcp",
      "args": [],
      "env": {
        "BRIEF_API_BASE": "https://your-api.example.com"
      }
    }
  }
}

Note: Authenticate once with brief-mcp login (device flow). Do not include tokens in this JSON.

Website: https://briefhq.ai

Local dev alternative (monorepo):

{
  "mcpServers": {
    "brief": {
      "command": "node",
      "args": ["./packages/mcp-server/bin/mcp-server.js"],
      "env": {
        "BRIEF_API_BASE": "http://localhost:3030",
        "BRIEF_WORKSPACE_ID": "brief-inc-dev",
        "BRIEF_API_TOKEN": "dev-token"
      }
    }
  }
}

JSON-RPC server

mcp-server bin starts stdio server with Brief tools.