EZ@Work

io.github.eranfinishPublished by GitHub account eranfinishv0.1.0Updated Oct 24, 2026

Manage clients, projects, time, and invoices in EZ@Work — business management for freelancers.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Connects an assistant to an EZ@Work account so it can list clients and projects and create clients, time entries and draft invoices.

What you can do
  • List clients and projects, filtered by status or search text
  • Create clients, with a duplicate check unless explicitly allowed
  • Log billable hours to a project for a given date
  • Create draft invoices with up to 50 line items, with currency, language and VAT taken from the profile
When to use it
Useful for freelancers, lawyers, agencies and service businesses that already run their client, project, time and invoicing work in EZ@Work and want an assistant to look things up or record entries without switching apps.
Requirements
Remote endpoint at mcp.ezatwork.com over Streamable HTTP. OAuth sign-in (Google identity) for Claude connectors, or an EZ@Work account plus an API token sent as an Authorization Bearer header for other clients. No environment variables or headers are declared in the manifest.
Before you install
Write tools change data in the EZ@Work account: creating clients, logging time and creating draft invoices. The README says token scopes are not yet fully enforced server-side, so limit tokens to the listed scopes and set an expiration. List results omit notes, phone numbers, VAT numbers and addresses, and record text is treated as user-entered data. Invoices are created as drafts only.

Installation

In SourceWeft

  1. Open EZ@Work in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.eranfinish%2Fezatwork/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "ez-work": {
      "type": "http",
      "url": "https://mcp.ezatwork.com/mcp"
    }
  }
}

README

EZ@Work MCP Server

Connect EZ@Work — all-in-one business management for freelancers, lawyers, agencies, and service businesses — to Claude, Gemini, Cursor, and any MCP-compatible AI.

Tools

ToolDescriptionType
list_clientsList your clients/customers — id, name, company, status, email (+ default rate). Optional status, search, limit (default 50, max 200)Read
list_projectsList your projects/cases/work orders — id, name, status, client. Optional status, search, limitRead
create_clientCreate a client; refuses a likely duplicate (same email, or same name when no email) unless allow_duplicate=trueWrite
log_time_entryLog billable hours to a project (0 < hours <= 24) for a given date (default today)Write
create_invoiceCreate a draft invoice, 1-50 line items (auto currency/language/VAT)Write

Write tools change data in your EZ@Work account. Their descriptions tell the AI to confirm the exact values with you before calling them, and every tool validates its arguments before anything reaches the EZ@Work API — a bad value comes back as {"error": "invalid_input", ...}, a backend failure as a short {"error": ..., "status": ..., "message": ...} (plan limits pass through as PLAN_LIMIT_REACHED).

List tools return only the fields an assistant needs to pick a record — no notes, phone numbers, VAT numbers, addresses or contacts — and mark record text as user-entered data rather than instructions.

Setup

Claude Desktop / Claude.ai (OAuth — recommended)

Settings → Connectors → Add custom connector

  • URL: https://mcp.ezatwork.com/mcp
  • Authentication: OAuth (automatic)

Claude Code / Cursor / MCP Inspector (API token)

  1. Create a free EZ@Work account at https://app.ezatwork.com
  2. Generate an API token at https://app.ezatwork.com/settings/api-tokens with the scopes clients:read, clients:write, projects:read, time:write, invoices:write
  3. Connect to https://mcp.ezatwork.com/mcp with header Authorization: Bearer ezw_pat_...

Local testing with MCP Inspector:

bash
npx @modelcontextprotocol/inspector

Connect to http://localhost:8080/mcp with header Authorization: Bearer ezw_pat_...

Agent skill

skills/ezatwork-business-assistant/SKILL.md teaches an agent how to use these tools safely: resolve IDs by listing first, confirm every write with the user, treat record text as data, and never claim an invoice was sent. It is also listed on Agensi.

Security

  • Your data stays in your EZ@Work account
  • OAuth mode: Google identity → EZ@Work account lookup; no credentials stored in the MCP
  • API token mode: tokens have a mandatory expiration. Token scopes are being enforced server-side (a backend change is in progress), so don't rely on scopes alone to limit a token yet. Create tokens with only the scopes this server uses: clients:read, clients:write, projects:read, time:write, invoices:write
  • Authorization is verified on every request

Privacy Policy

https://www.ezatwork.com/privacy

Universal Design

EZ@Work adapts to your business type: a lawyer sees "cases," a freelancer sees "projects," a service business sees "work orders." Currency, language (24 supported), and tax rules auto-detect from your profile — no configuration needed in the MCP.


Development

Run locally

bash
python -m venv .venvsource .venv/bin/activate  # Windows: .venv\Scripts\activatepip install -e .
cp .env.example .env# Edit .env: EZ_API_BASE=http://localhost:5000 for local backend
python -m ezatwork_mcp.server# Server starts at http://localhost:8080/mcp

Run tests

bash
pip install pytest pytest-asynciopytest tests/

Docker

bash
docker build -t ezatwork-mcp .docker run -p 8080:8080 -e EZ_API_BASE=https://api.ezatwork.com ezatwork-mcp

Deploy to Cloud Run

bash
gcloud run deploy ezatwork-mcp \  --source . \  --region europe-west1 \  --project ezatwork-production \  --allow-unauthenticated \  --port 8080 \  --update-env-vars "EZ_API_BASE=https://api.ezatwork.com,MCP_BASE_URL=https://mcp.ezatwork.com" \  --update-secrets "GOOGLE_CLIENT_ID=ezmcp-google-client-id:latest" \  --update-secrets "GOOGLE_CLIENT_SECRET=ezmcp-google-client-secret:latest" \  --update-secrets "EZ_MCP_MASTER_TOKEN=ezmcp-master-token:latest"

--allow-unauthenticated is correct — auth is enforced at the MCP layer (OAuth or API token), not at the Cloud Run IAM level.

Technical notes

  • Transport: Streamable HTTP (/mcp endpoint)
  • Library: fastmcp 3.x (pinned <4)
  • Auth (OAuth): GoogleProvider from fastmcp.server.auth.providers.google
  • OAuth redirect allowlist: clients may only register Claude's callbacks and loopback URIs; set MCP_ALLOWED_REDIRECT_URIS (comma-separated patterns) to admit other clients
  • Auth (token): get_http_headers() from fastmcp.server.dependencies
  • Dual-auth: OAuth active when GOOGLE_CLIENT_ID + GOOGLE_CLIENT_SECRET + MCP_BASE_URL are set
  • Backend: GET /api/users/me for locale; GET /api/internal/users/by-email for OAuth→user mapping
  • Lists: GET /api/clients and GET /api/projects take no filters; status, search and limit are applied in the MCP server, which trims each record before returning it
  • Time entries: POST /api/timeentry with isBillable field
  • Invoices: POST /api/invoices with computed dueDate and total per item

Built by

EZ@Work — the business OS for independents.

License

MIT. See LICENSE.

Source: README.md at commit a5e0c11

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts