@brevitaz/mcp-server

MCP server that exposes UnleashTeams HR & Performance Management data to AI assistants via the Model Context Protocol.

Prerequisites

• Node.js 18+ (LTS recommended)
• A Personal Access Token (PAT) from your UnleashTeams instance

Quick Start

1. Generate a Personal Access Token

1. Log in to UnleashTeams
2. Go to Settings > Tokens
3. Click Generate Token
4. Copy the token — you'll need it in the next step

2. Configure your IDE

Copy the JSON snippet for your IDE and replace the placeholder values:

Claude Code

Add to your Claude Code MCP settings (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "unleashteams": {
      "command": "npx",
      "args": ["@brevitaz/mcp-server"],
      "env": {
        "UNLEASHTEAMS_API_URL": "https://your-instance.unleashteams.com",
        "UNLEASHTEAMS_PAT": "your-personal-access-token"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "unleashteams": {
      "command": "npx",
      "args": ["@brevitaz/mcp-server"],
      "env": {
        "UNLEASHTEAMS_API_URL": "https://your-instance.unleashteams.com",
        "UNLEASHTEAMS_PAT": "your-personal-access-token"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP settings (~/.windsurf/mcp.json):

{
  "mcpServers": {
    "unleashteams": {
      "command": "npx",
      "args": ["@brevitaz/mcp-server"],
      "env": {
        "UNLEASHTEAMS_API_URL": "https://your-instance.unleashteams.com",
        "UNLEASHTEAMS_PAT": "your-personal-access-token"
      }
    }
  }
}

3. Verify the connection

After configuring, restart your IDE. The AI assistant should now have access to UnleashTeams tools. Try asking:

"Use the whoami tool to check my UnleashTeams connection"

Available Tools

| Tool | Description | |------|-------------| | whoami | Verify authentication and connectivity | | list-projects | List all tracker projects | | get-project | Get project details including members | | list-sprints | List sprints in a project | | get-sprint-board | Get board view of a sprint | | get-ticket | Get full ticket detail by key | | search-tickets | Search tickets with filters | | list-one-on-one-series | List your 1:1 meeting series | | list-upcoming-meetings | List upcoming 1:1 meetings | | get-meeting | Get meeting details with agenda | | list-action-items | List open action items from 1:1s | | search-users | Search employees by name or email | | get-user | Get employee profile by ID | | get-org-chart | Get direct reports for an employee | | get-my-profile | Get your own employee profile |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | UNLEASHTEAMS_API_URL | Yes | Base URL of your UnleashTeams backend (e.g., https://app.unleashteams.com) | | UNLEASHTEAMS_PAT | Yes | Personal Access Token generated from Settings > Tokens |

CLI Flags

npx @brevitaz/mcp-server              Start the MCP server
npx @brevitaz/mcp-server --version    Print version and exit
npx @brevitaz/mcp-server --help       Show help message

Troubleshooting

"Missing required environment variable UNLEASHTEAMS_PAT"

You need to set the UNLEASHTEAMS_PAT environment variable. Generate a token at Settings > Tokens in UnleashTeams and add it to your IDE's MCP configuration.

"Missing required environment variable UNLEASHTEAMS_API_URL"

Set the UNLEASHTEAMS_API_URL to the base URL of your UnleashTeams instance (e.g., https://app.unleashteams.com). Do not include a trailing slash or path.

Connection refused / Network error

• Verify the UNLEASHTEAMS_API_URL is correct and reachable from your machine
• Check that the UnleashTeams backend is running
• If behind a VPN, ensure you are connected

Authentication failed (401/403)

• Your PAT may have expired — generate a new one at Settings > Tokens
• Verify you copied the full token string without extra spaces
• Check that your user account has not been deactivated

Tools not appearing in IDE

• Restart your IDE after updating MCP configuration
• Verify the JSON configuration is valid (no trailing commas, correct structure)
• Check the IDE's MCP logs for error messages

License

UNLICENSED