@thedistance/charliehr-mcp

MCP server for the CharlieHR API — use with Claude, ChatGPT, Cursor, and any MCP-compatible AI client.

Published under the @thedistance scope (same pattern as @thedistance/forecast-mcp).

Install (Cursor)

Add to .cursor/mcp.json (project) or Cursor Settings → Tools & MCP:

{
  "mcpServers": {
    "charliehr": {
      "command": "npx",
      "args": ["-y", "@thedistance/charliehr-mcp"],
      "env": {
        "CHARLIEHR_CLIENT_ID": "your_client_id",
        "CHARLIEHR_CLIENT_SECRET": "your_client_secret",
        "CHARLIEHR_ENABLE_SENSITIVE": "false"
      }
    }
  }
}

Pin a version: "args": ["-y", "@thedistance/[email protected]"]

Environment variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | CHARLIEHR_CLIENT_ID | Yes | — | API client ID from CharlieHR | | CHARLIEHR_CLIENT_SECRET | Yes | — | API client secret | | CHARLIEHR_ENABLE_SENSITIVE | No | false | Set true to allow bank account and salary tools to call the API | | CHARLIEHR_BASE_URL | No | https://charliehr.com/api/v1 | API base URL |

Create credentials in your CharlieHR account API/integration settings.

Sensitive tools

Bank and salary tools are always listed for discovery. They return an error until CHARLIEHR_ENABLE_SENSITIVE=true.

Local development

cp .env.example .env   # add credentials
npm install
npm run dev            # tsx src/index.ts (loads .env via dotenv)
# or
npm run build && npm start

Publish to npm

You must be logged in as a maintainer of the @thedistance scope (dev_at_thedistance_dot_co_dot_uk):

npm login
npm run build && npm test
npm publish --access public

Verify: npx -y @thedistance/charliehr-mcp (with env vars in MCP config).

License

MIT