v1.0.0 — published on npm

Clock in from
your terminal

MCP server for Woffu. Connect it to Claude, Cursor, Windsurf, or any AI agent. Say "fichame" and you're clocked in.

$ npx woffu-mcp copy
View on GitHub

Works with

Claude Code Cursor Windsurf VS Code Claude Desktop Hermes

7 tools. One command.

Everything you need to manage your Woffu attendance without leaving your editor.

clock_toggle

Auto-detects entry or exit. The one you'll use every day.

clock_in

Force clock in. Skips if already clocked in.

clock_out

Force clock out. Skips if not clocked in.

get_status

Working or not, today's signs, schedule, vacation balance.

get_week_summary

Hours worked vs scheduled this week, per day.

get_vacations

Allocated, used, available. All your days at a glance.

get_holidays

Company holidays for any year. Never miss a day off.

It feels like this

Natural language in, structured actions out.

claude — woffu-mcp
Fichame
Clocked in. Entry registered at 09:02:15. 3 signs today.
How's my week looking?
Mon: 8h32m / 8h45m
Tue: 6h15m / 8h45m (in progress)
Wed–Fri: pending
Vacation days left?
18 available out of 23 allocated. 5 used.

Connect to your agent

Three env vars. Pick your tool.

~/.claude/settings.json
{
  "mcpServers": {
    "woffu": {
      "command": "npx",
      "args": ["-y", "woffu-mcp"],
      "env": {
        "WOFFU_COMPANY": "mycompany",
        "WOFFU_EMAIL": "me@company.com",
        "WOFFU_PASSWORD": "your-password"
      }
    }
  }
}
.cursor/mcp.json
{
  "mcpServers": {
    "woffu": {
      "command": "npx",
      "args": ["-y", "woffu-mcp"],
      "env": {
        "WOFFU_COMPANY": "mycompany",
        "WOFFU_EMAIL": "me@company.com",
        "WOFFU_PASSWORD": "your-password"
      }
    }
  }
}
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "woffu": {
      "command": "npx",
      "args": ["-y", "woffu-mcp"],
      "env": {
        "WOFFU_COMPANY": "mycompany",
        "WOFFU_EMAIL": "me@company.com",
        "WOFFU_PASSWORD": "your-password"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "woffu": {
      "command": "npx",
      "args": ["-y", "woffu-mcp"],
      "env": {
        "WOFFU_COMPANY": "mycompany",
        "WOFFU_EMAIL": "me@company.com",
        "WOFFU_PASSWORD": "your-password"
      }
    }
  }
}
~/.hermes/config.yaml
mcp_servers:
  woffu:
    command: npx
    args:
      - "-y"
      - "woffu-mcp"
    env:
      WOFFU_COMPANY: "mycompany"
      WOFFU_EMAIL: "me@company.com"
      WOFFU_PASSWORD: "your-password"
    enabled: true

How it works

No middleware, no hosted service. Everything runs on your machine.

Your Agent woffu-mcp Woffu API

Local only

Your credentials never leave your machine. No cloud, no proxy.

Auto clock logic

Even sign count = entry, odd = exit. Holidays and weekends skipped.

Open standard

MCP by Anthropic — works with any compatible agent.