ezyVet MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ezyVet MCP Show upcoming appointments for dog Rex."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ezyVet MCP
Model Context Protocol (MCP) server for ezyVet — cloud-based veterinary practice management software.
Talk to ezyVet from Claude, Cursor, or any MCP client. Read animals (patients), contacts (owners), appointments, consults, invoices. Create new records. Tokens are OAuth2 client-credentials with 12-hour TTL, auto-refreshed.
Built against the ezyVet REST API. No existing MCP for ezyVet — this is the first.
What you can do with it
You: "Find dog 'Rex' for owner Sarah Johnson and show upcoming appointments."
Claude: *find_contacts + find_animals + find_appointments → summary*
You: "Book a vaccination appointment for animal 4523 next Tuesday at 10am."
Claude: *list_appointment_types, then create_appointment with right type_id*
You: "Open a new consult for the cat we just saw — note the diagnosis."
Claude: *create_consult with animal_id, vet_id, notes*
You: "What invoices does contact 892 have from this month?"
Claude: *find_invoices with contact_id + date range*Related MCP server: xero-mcp-enhanced
Install
pip install -e .Configure
Register as an ezyVet integration partner to get your credentials.
export EZYVET_PARTNER_ID="..."
export EZYVET_CLIENT_ID="..."
export EZYVET_CLIENT_SECRET="..."
export EZYVET_SITE_UID="..."
export EZYVET_SCOPE="read-animal read-contact read-appointment read-consult read-invoice read-user"Use with Claude Desktop
{
"mcpServers": {
"ezyvet_mcp": {
"command": "ezyvet_mcp",
"env": {
"EZYVET_PARTNER_ID": "...",
"EZYVET_CLIENT_ID": "...",
"EZYVET_CLIENT_SECRET": "...",
"EZYVET_SITE_UID": "...",
"EZYVET_SCOPE": "..."
}
}
}
}Tools
Tool | Type | What it does |
| Diagnostic | Mints a token + lists users |
| Read | Single animal (patient) |
| Read | Search animals |
| Write | New patient |
| Write | Patch patient fields |
| Read | Single contact (owner) |
| Read | Search owners |
| Write | New owner |
| Read | List appointments |
| Write | Book appointment |
| Read | List visits |
| Write | Open visit |
| Read | List invoices |
| Read | Reference: species |
| Read | Reference: breeds |
| Read | Reference: appointment types |
| Read | Reference: practice staff |
API coverage
Maps MCP tools to ezyVet's 216-endpoint REST API. Full docs: https://developers.ezyvet.com/
Rate limits
ezyVet throttles most endpoints at 60 req/min and globally at 180 req/min per database. The client auto-retries 401s (token refresh) but doesn't retry 429s — slow down on your end if you hit them.
Development
pip install -e ".[dev]"
pytest
ezyvet_mcpNeed a custom MCP for your SaaS?
I build production-grade MCP servers for vertical SaaS — insurance, dental, veterinary, legal, property mgmt, home services. Typical engagement: 2-4 weeks, $25K-$120K. Source-owned, MIT-licensed, no vendor lock-in.
See sanjibani/mcp-services or email sanjibani@users.noreply.github.com.
Ships in the sanjibani vertical-MCP portfolio — see also hawksoft-mcp, open-dental-mcp, ezyvet-mcp, jobber-mcp, paid-skills, mcp-vertical-template.
MIT.
Acknowledgements
ezyVet for the public REST API + OAuth flow
Built using mcp-vertical-template
Inspired by sanjibani/hawksoft-mcp and sanjibani/open-dental-mcp (same template pattern)
See also
Available Tools
17 toolscreate_animalB
Create a new animal (patient). animal_json is a JSON object string
matching ezyVet's animal schema (at minimum: name, species_id).
Inputs: animal_json (required). Returns: result
create_appointmentC
Book a new appointment. appointment_json is a JSON object string.
Inputs: appointment_json (required). Returns: result
create_consultC
Open a new clinical consult (visit record).
Inputs: consult_json (required). Returns: result
create_contactC
Create a new contact (owner). contact_json is a JSON object string.
Inputs: contact_json (required). Returns: result
find_animalsB
Search animals by name / species / breed. Returns the standard
{meta, items, messages} envelope from ezyVet.
Inputs: name, page, limit, breed_id, +1 more. Returns: result
find_appointmentsB
List appointments. Use start_date + end_date for a date range,
animal_id for a specific patient's visits.
Inputs: page, limit, end_date, animal_id, +2 more. Returns: result
find_consultsC
List clinical consults (visits).
Inputs: page, limit, end_date, animal_id, +1 more. Returns: result
find_contactsC
Search contacts by name or email.
Inputs: page, email, limit, last_name, +1 more. Returns: result
find_invoicesC
List invoices, optionally filtered by contact and date range.
Inputs: page, limit, end_date, contact_id, +1 more. Returns: result
get_animalA
Fetch a single animal (patient) by ezyVet ID.
Inputs: animal_id (required). Returns: result
get_contactC
Fetch a contact (the pet owner) by ID.
Inputs: contact_id (required). Returns: result
health_checkB
Verify credentials by minting an OAuth token and listing users.
Inputs: no named parameters. Returns: result
list_appointment_typesA
List appointment type definitions (consult, vaccination, surgery, etc.).
Inputs: no named parameters. Returns: result
list_breedsB
List animal breeds.
Inputs: no named parameters. Returns: result
list_speciesA
List animal species (dog, cat, rabbit, etc.).
Inputs: no named parameters. Returns: result
list_usersA
List practice users (vets, nurses, receptionists).
Inputs: no named parameters. Returns: result
update_animalA
Patch an animal record. updates_json is a JSON object with only the
fields you want to change (e.g. '{"name": "Rex II", "weight": 32.4}').
Inputs: animal_id (required), updates_json (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool targets a distinct resource-action pair (e.g., create_animal, find_animals, get_animal, update_animal), with no overlapping purposes. All tools are clearly separable.
All tool names follow a consistent verb_noun pattern in snake_case. Create/find/get/update for nouns, and list_ for type enumerations, with no mixing of styles.
17 tools is well-scoped for a veterinary practice management server. Each tool serves a distinct purpose, covering animals, appointments, consults, contacts, invoices, and administrative lists without unnecessary bloat.
The set covers core CRUD for animals but misses update and delete for appointments, consults, contacts, and invoices. Creation and reading are well-covered, but missing mutability options create gaps for typical workflows.
Related MCP Connectors
Hosted MCP server for Cliniko — patients, appointments, availability, and invoices for AI agents.
MCP server for lacita - appointment management software
MCP server for Zooza — class scheduling, attendance, and booking for activity businesses.
MCP server for Codat — companies, connections, invoices, bills and financial statements.
Related MCP Servers
- AlicenseAqualityCmaintenanceRead-only MCP server for Gingr pet-care facility data, enabling queries about owners, animals, reservations, appointments, services, and staff via natural language.79 npmMIT
- AlicenseNot gradedqualityDmaintenanceAn enhanced MCP server for Xero, enabling natural language interaction with your Xero organisation for accounting tasks like invoices, contacts, bank transactions, and payroll.MIT
- FlicenseBqualityDmaintenanceMCP server for interacting with the Eventin booking system, enabling natural language management of bookings, events, and venues.2-
- AlicenseNot gradedqualityBmaintenanceEnables managing veterinary clinic operations via natural language by integrating Vetmanager REST API with MCP clients.1MIT