
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.
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.
Installation
In SourceWeft
- Open EZ@Work in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- 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.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
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)
- Create a free EZ@Work account at https://app.ezatwork.com
- 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 - Connect to
https://mcp.ezatwork.com/mcpwith headerAuthorization: Bearer ezw_pat_...
Local testing with MCP 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
Run tests
Docker
Deploy to Cloud Run
--allow-unauthenticatedis correct — auth is enforced at the MCP layer (OAuth or API token), not at the Cloud Run IAM level.
Technical notes
- Transport: Streamable HTTP (
/mcpendpoint) - Library:
fastmcp 3.x(pinned<4) - Auth (OAuth):
GoogleProviderfromfastmcp.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()fromfastmcp.server.dependencies - Dual-auth: OAuth active when
GOOGLE_CLIENT_ID+GOOGLE_CLIENT_SECRET+MCP_BASE_URLare set - Backend:
GET /api/users/mefor locale;GET /api/internal/users/by-emailfor OAuth→user mapping - Lists:
GET /api/clientsandGET /api/projectstake no filters; status, search and limit are applied in the MCP server, which trims each record before returning it - Time entries:
POST /api/timeentrywithisBillablefield - Invoices:
POST /api/invoiceswith computeddueDateandtotalper item
Built by
EZ@Work — the business OS for independents.
License
MIT. See LICENSE.
Source: README.md at commit a5e0c11
Tools
0Version history
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