Ever Gauzy

Open business platform with employee time tracking, HR and scheduling, and an official 323-tool MCP server.

AdaptableOperable Business appWeb app Deterministic TypeScript MCP server License: AGPL-3.0

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.

Use it when

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

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'

Last activity Sep 2, 2026. Fit: adaptable 2, operable 3.

Editions

Self-hosted · Free open source

Clonegit clone https://github.com/ever-co/ever-gauzy
ImageContainer
DownloadDownload

Gauzy SaaS (alpha) · Free open source

HostedOpen the hosted app

For agents: JSON · Markdown

Adaptable: what is yours to change

Make it yours

Config only20 things to edit

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.

Env vars: 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
Config files: .env.sample .env.compose .env.local docker-compose.yml docker-compose.demo.yml
Prompt files: none
Accounts you need: none

Source

github.com/ever-co/ever-gauzy
AGPL-3.0 license
Last commit Sep 2, 2026
4,361 stars

Operable: what an agent can drive

Interface

OfficialMCP serverpublished by the builderremote or local

How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.

Docs: github.com/ever-co/ever-gauzy/tree/develop/packages/mcp-server
Tools: AuthTool TimerTool ProjectTool employee tools task tools daily plan tools organization contact tools

Reach

Partial coverage. 5 of 10 jobs reachable through the stated interface.

Job	Through the interface	Evidence
Start and stop the time tracker	Reachable	packages/mcp-server README: Timer & Time Tracking (3 tools)
Manage employees	Reachable	mcp-server README: Employee Management (15 tools) with bulk CRUD
Manage projects and tasks	Reachable	mcp-server README: Project Management (14 tools), Task Management (16 tools)
Daily planning for people and teams	Reachable	mcp-server README: Daily Planning (17 tools)
Manage contacts, clients and leads	Reachable	mcp-server README: Organization Contacts (17 tools)
Review timesheets and activity reports	Undetermined	not among the categories shown in the mcp-server README excerpt; REST API at api.gauzy.co/docs likely covers it
Time-off requests and approvals	Undetermined	module exists per README feature list; MCP tool coverage not confirmed
Schedules, appointments and events	Undetermined	module exists per README feature list; MCP tool coverage not confirmed
Invoices, estimates and payments	Undetermined	module exists; not in the MCP categories seen; REST Swagger likely covers it
Screenshots and activity monitoring from the desktop timer	Not reachable	captured by the Electron desktop timer app, not by an API call

Code stack

Languages: TypeScript
Frameworks: NestJSAngularNxTypeORMMikroORMElectron
Package manager: yarn
Database: PostgreSQLMySQLSQLite
Hosting target: dockerkubernetesdigitaloceanaws
Built: Mixed (recorded, never ranked)

Model stack

Providers: any MCP client
Models: none
Keys you need: none
Prompts live in: none

Evidence and confidence

Field	Where it was seen	Confidence
formFactor	README: Angular web UI plus NestJS API, Electron desktop apps also offered	95%
executionModel	core platform has no model at runtime; AI integrations are optional	85%
operability	packages/mcp-server and apps/mcp in the ever-co/ever-gauzy repo; docs.gauzy.co MCP Server section says 323 tools	90%
effort	.env.sample in repo; README names the required secrets and .env.compose	80%
editions	README: AGPL self-host, downloads page, app.gauzy.co SaaS alpha; no pricing found on docs.gauzy.co	60%
active	shortlist pushedAt 2026-09-02	–
reach		60%
provenance		40%

Open questions

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

github.com/ever-co/ever-gauzy sourcing:scheduling-staffing:curated
api.gauzy.co/docs sourcing:scheduling-staffing:curated
docs.gauzy.co/ analysis:scheduling-staffing
github.com/ever-co/ever-gauzy/blob/develop/packages/mcp-server/README.md analysis:scheduling-staffing