bragdoc-mcp

An MCP server that helps you capture professional achievements using the STAR method. Claude interviews you — asking questions iteratively — until each achievement is captured with quantified impact and business outcomes. Once your achievements are logged you can generate period summaries and performance review self-assessments, all from Claude Desktop.

Requirements

• Node.js 18+
• Claude Desktop (or any MCP-compatible client)

Installation

No install required. Run directly via npx:

npx -y bragdoc-mcp

Claude Desktop Configuration

Add to your Claude Desktop MCP config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop after saving.

Data Storage

All data is stored locally at ~/.bragdoc/:

• brag.json — your achievements
• competencies.json — your role competency framework
• goals.json — your OKRs for the current review cycle

First Use

Once connected, try these prompts in Claude Desktop:

Capture an achievement:

Use the "Add Achievement" prompt — Claude will interview you using the STAR method until every field is captured with quantified impact.

Weekly review:

Use the "Weekly Update" prompt — Claude checks what you accomplished and suggests new achievements to capture.

Set up context (do this once):

Use "Set Up Competencies" to enter your organisation's competency framework. Use "Set Up Goals" to enter your OKRs for the current review cycle.

Generate a summary or review:

Use "Period Summary" with a period like "Q1 2026" or "March 2026". Use "Performance Review" with your review period to generate a structured self-assessment.

Available Tools

| Tool | Description | |------|-------------| | add_achievement | Add an achievement with STAR fields | | list_achievements | List achievements with optional date/tag/keyword filters | | get_achievement | Retrieve a single achievement by ID | | update_achievement | Update any field of an existing achievement | | delete_achievement | Delete an achievement | | get_competencies | Retrieve your competency list | | set_competencies | Save your competency list | | get_goals | Retrieve your goals list | | set_goals | Save your goals list |

Resources

Three MCP resources are exposed for direct data access:

• bragdoc://achievements
• bragdoc://competencies
• bragdoc://goals

Local Development

git clone https://github.com/YOUR_USERNAME/bragdoc-mcp
cd bragdoc-mcp
npm install
npm run build
npm test

For local Claude Desktop development, use an absolute path in the config:

{
  "mcpServers": {
    "bragdoc": {
      "command": "node",
      "args": ["/absolute/path/to/bragdoc-mcp/dist/index.js"]
    }
  }
}