{
  "version": "2",
  "generatedAt": "2026-11-03T22:49:39.280Z",
  "listing": {
    "slug": "ever-co--ever-gauzy",
    "name": "Ever Gauzy",
    "tagline": "Open business platform with employee time tracking, HR and scheduling, and an official 323-tool MCP server.",
    "shortTagline": "Time tracking, HR and scheduling",
    "description": "Ever Gauzy is an AGPL business-management platform: employee time and activity tracking, HRM, time-off approvals, schedules and appointments, projects and tasks, CRM, invoicing and more, with desktop timer apps. The Builder ships a REST API with Swagger and an MCP server package (@gauzy/mcp-server, apps/mcp) in the same monorepo. Scheduling is one module among many.",
    "capabilities": [
      "adaptable",
      "operable"
    ],
    "vertical": "scheduling-staffing",
    "alternativeTo": [
      "Hubstaff",
      "BambooHR"
    ],
    "shape": "business-app",
    "formFactor": "web-app",
    "executionModel": "deterministic",
    "provenance": "mixed",
    "codeStack": {
      "languages": [
        "TypeScript"
      ],
      "frameworks": [
        "NestJS",
        "Angular",
        "Nx",
        "TypeORM",
        "MikroORM",
        "Electron"
      ],
      "packageManager": "yarn",
      "database": [
        "PostgreSQL",
        "MySQL",
        "SQLite"
      ],
      "hostingTarget": [
        "docker",
        "kubernetes",
        "digitalocean",
        "aws"
      ]
    },
    "modelStack": {
      "providers": [
        "any MCP client"
      ],
      "models": [],
      "requiredKeys": [],
      "promptLocations": [],
      "tools": [
        "AuthTool",
        "TimerTool",
        "ProjectTool",
        "employee tools",
        "task tools",
        "daily plan tools",
        "organization contact tools"
      ]
    },
    "repos": [
      {
        "url": "https://github.com/ever-co/ever-gauzy",
        "owner": "ever-co",
        "name": "ever-gauzy",
        "license": "AGPL-3.0",
        "stars": 4361,
        "lastCommit": "2026-09-02"
      }
    ],
    "interface": {
      "kind": "mcp",
      "url": "https://github.com/ever-co/ever-gauzy/tree/develop/packages/mcp-server",
      "official": true,
      "hosted": "both"
    },
    "operability": "official",
    "recommendedWrapper": null,
    "reach": [
      {
        "job": "Start and stop the time tracker",
        "reachable": true,
        "evidence": "packages/mcp-server README: Timer & Time Tracking (3 tools)"
      },
      {
        "job": "Manage employees",
        "reachable": true,
        "evidence": "mcp-server README: Employee Management (15 tools) with bulk CRUD"
      },
      {
        "job": "Manage projects and tasks",
        "reachable": true,
        "evidence": "mcp-server README: Project Management (14 tools), Task Management (16 tools)"
      },
      {
        "job": "Daily planning for people and teams",
        "reachable": true,
        "evidence": "mcp-server README: Daily Planning (17 tools)"
      },
      {
        "job": "Manage contacts, clients and leads",
        "reachable": true,
        "evidence": "mcp-server README: Organization Contacts (17 tools)"
      },
      {
        "job": "Review timesheets and activity reports",
        "reachable": null,
        "evidence": "not among the categories shown in the mcp-server README excerpt; REST API at api.gauzy.co/docs likely covers it"
      },
      {
        "job": "Time-off requests and approvals",
        "reachable": null,
        "evidence": "module exists per README feature list; MCP tool coverage not confirmed"
      },
      {
        "job": "Schedules, appointments and events",
        "reachable": null,
        "evidence": "module exists per README feature list; MCP tool coverage not confirmed"
      },
      {
        "job": "Invoices, estimates and payments",
        "reachable": null,
        "evidence": "module exists; not in the MCP categories seen; REST Swagger likely covers it"
      },
      {
        "job": "Screenshots and activity monitoring from the desktop timer",
        "reachable": false,
        "evidence": "captured by the Electron desktop timer app, not by an API call"
      }
    ],
    "editions": [
      {
        "name": "Self-hosted",
        "price": null,
        "open": true,
        "distributions": [
          {
            "kind": "source",
            "url": "https://github.com/ever-co/ever-gauzy"
          },
          {
            "kind": "container",
            "url": "https://github.com/ever-co/ever-gauzy/blob/develop/docker-compose.yml",
            "command": "docker-compose up -d"
          },
          {
            "kind": "binary",
            "url": "https://web.gauzy.co/downloads"
          }
        ]
      },
      {
        "name": "Gauzy SaaS (alpha)",
        "price": null,
        "open": true,
        "distributions": [
          {
            "kind": "hosted",
            "url": "https://app.gauzy.co"
          }
        ]
      }
    ],
    "skills": {
      "kind": "none",
      "paths": [],
      "install": null,
      "note": "No SKILL.md, Claude Code plugin, or skills install target in the repo."
    },
    "customization": {
      "summary": "Copy .env.sample to .env (or edit .env.compose for Docker) and set the four secrets the API refuses to start without: JWT_SECRET, JWT_REFRESH_TOKEN_SECRET, JWT_VERIFICATION_TOKEN_SECRET, EXPRESS_SESSION_SECRET. Then DB_TYPE and DB_ORM, API_BASE_URL and CLIENT_BASE_URL, branding (APP_NAME, APP_LOGO), and the OAuth pairs you need. Modules, roles and organization settings are configured in the UI. The full stack (OpenSearch, MinIO, Redis, Cube, Jitsu) is optional but heavy.",
      "envVars": [
        "JWT_SECRET",
        "JWT_REFRESH_TOKEN_SECRET",
        "JWT_VERIFICATION_TOKEN_SECRET",
        "EXPRESS_SESSION_SECRET",
        "DB_TYPE",
        "DB_ORM",
        "API_BASE_URL",
        "CLIENT_BASE_URL",
        "APP_NAME",
        "APP_LOGO",
        "REDIS_URL",
        "GOOGLE_CLIENT_ID",
        "GOOGLE_CLIENT_SECRET",
        "MICROSOFT_CLIENT_ID",
        "MICROSOFT_CLIENT_SECRET"
      ],
      "configFiles": [
        ".env.sample",
        ".env.compose",
        ".env.local",
        "docker-compose.yml",
        "docker-compose.demo.yml"
      ],
      "promptFiles": [],
      "effort": "config-only",
      "editCount": 20
    },
    "useWhen": [
      "I run an agency with contractors and want time tracking, time-off and invoicing under one roof I control",
      "I want my agent to log time, plan the day and update tasks for the team through MCP"
    ],
    "accounts": [],
    "active": true,
    "lastActivity": "2026-09-02",
    "gotchas": [
      "AGPL-3.0 copyleft",
      "Breadth is the cost: this is an ERP; scheduling and staffing are two modules of dozens, and production compose pulls PostgreSQL, Redis, OpenSearch, MinIO, Jitsu, Cube and Zipkin",
      "The API refuses to start on blank or default secrets (README Production section)",
      "MCP tool counts in packages/mcp-server/README.md were last updated 2025-08-05",
      "Hosted app.gauzy.co is labelled alpha and 'use it cautiously'"
    ],
    "fit": {
      "adaptable": 2,
      "operable": 3
    },
    "evidence": {
      "formFactor": "README: Angular web UI plus NestJS API, Electron desktop apps also offered",
      "executionModel": "core platform has no model at runtime; AI integrations are optional",
      "operability": "packages/mcp-server and apps/mcp in the ever-co/ever-gauzy repo; docs.gauzy.co MCP Server section says 323 tools",
      "effort": ".env.sample in repo; README names the required secrets and .env.compose",
      "editions": "README: AGPL self-host, downloads page, app.gauzy.co SaaS alpha; no pricing found on docs.gauzy.co",
      "active": "shortlist pushedAt 2026-09-02"
    },
    "confidence": {
      "formFactor": 0.95,
      "executionModel": 0.85,
      "operability": 0.9,
      "effort": 0.8,
      "reach": 0.6,
      "editions": 0.6,
      "provenance": 0.4
    },
    "openQuestions": [
      "Which of the 22 MCP tool categories cover timesheets, time-off and appointments? Read the MCP Tool Reference on docs.gauzy.co",
      "Is there pricing for the hosted SaaS once it leaves alpha?",
      "Provenance marked mixed only because AGENTS.md exists at the repo root"
    ],
    "sources": [
      {
        "url": "https://github.com/ever-co/ever-gauzy",
        "foundBy": "sourcing:scheduling-staffing:curated"
      },
      {
        "url": "https://api.gauzy.co/docs",
        "foundBy": "sourcing:scheduling-staffing:curated"
      },
      {
        "url": "https://docs.gauzy.co/",
        "foundBy": "analysis:scheduling-staffing"
      },
      {
        "url": "https://github.com/ever-co/ever-gauzy/blob/develop/packages/mcp-server/README.md",
        "foundBy": "analysis:scheduling-staffing"
      }
    ],
    "research": {
      "stage": "verified",
      "verdict": "unverified",
      "reason": "Official MCP server and REST API from the same org; documented .env surface but AGPL and a heavy stack for an SMB. Reach for scheduling modules needs the tool reference.",
      "disputed": []
    },
    "url": "apps/ever-co--ever-gauzy.html",
    "coverage": "partial",
    "paid": false,
    "source": "research/verified/ever-co--ever-gauzy.json"
  }
}