Connect Verdalia to your AI assistant

What it can do

• See your plants, their care schedule, reminders and alerts — the same things you see on your Overview.
• Log care you tell it about: watering, fertilizing, misting, notes and the rest, on one plant or several at once.
• Adjust a plant's own care schedule — its cadences, light preference or notes — and postpone a reminder.
• Add plants and rooms, rename a plant, edit its notes or species, move it to another room, or retire it to Past plants — and restore it from there.
• Look up your collection stats, streaks and badges, and search the species library.

And what it cannot do — by design, not by policy:

• It can never delete a plant, a room or a photo, or touch care you logged yourself. Retiring a plant isn't deleting it — it moves to Past plants with its history, and you can restore it. It can undo or correct care it logged itself for 7 days; anything else you correct in the app.
• It cannot upload photos or run photo identification.
• It cannot change your account, your plan, your payments or your settings.

The address you'll need

Every assistant asks for the same thing — the connector's address. There is no token to copy: you sign in to Verdalia in your browser and approve the connection there, and you can withdraw it just as easily.

https://api.verdalia.app/mcp/user

What you can ask

Talk to it the way you'd talk about your plants. A few things to try:

• “What needs water today?”It pulls up the plants with care due or overdue and picks out the ones waiting for water.
• “I watered the monstera and the fern”It logs a watering on both plants in one go.
• “Why is my aloe watered every 21 days?”It explains where that interval comes from — your own setting or the species baseline, the season, and how bright the plant's spot is.
• “Snooze the orchid's misting for 3 days”It puts that reminder off for 3 days — never by more than one care cycle, and never by more than 14 days.

Claude

In Claude, open Customize › Connectors › Add custom connector and paste the address above. Claude opens a Verdalia page where you sign in and approve the connection; after that it appears in your tools. Claude's Free plan includes one custom connector. The Claude desktop app uses this same flow — remote connectors are brokered through your Claude account rather than configured on the machine itself; claude_desktop_config.json is for local servers, a different feature.

ChatGPT

On the web, open chatgpt.com/plugins, select +, then Add custom MCP server. Paste the address above and approve the connection on the Verdalia page.

ChatGPT restricts write-capable connectors on some plans. If yours is one of them, the reading tools still work, and logging care and adding or changing plants and rooms simply won't be offered.

ChatGPT has been seen making changes — logging care, postponing a reminder, adding or moving a plant — without asking you first. Care it logs is marked “Logged by assistant” in Verdalia, and you can correct or remove it in the app. Plants and rooms it adds or changes aren't marked; you can edit them in the app (notes it replaces aren't kept) and restore a retired plant from Past plants.

Google Gemini

Gemini's custom connectors are only for people aged 18 or older who live in the US and use a personal Google Account rather than a work or school one, and they work in English only.

Go to gemini.google.com, open Settings, then Connected Apps, and choose Add a custom app. Enter the address above and select Next. Dynamic client registration is the default path, so you never need to touch the Advanced features credential fields.

Mistral Le Chat

Open Connectors, choose + Add Connector, then the Custom MCP Connector tab. Give the connector a name and paste the address above — a description is optional — then select Connect. Le Chat detects the authentication method itself and walks you through approving access. This is documented as an administrator-only feature, but on the Free, Pro and Student plans the account owner is the administrator by default, so nothing extra is needed.

Claude Code

Add it from your terminal, then run /mcp inside Claude Code to sign in.

claude mcp add --transport http verdalia https://api.verdalia.app/mcp/user

Desktop and editor clients

Clients that run on your own machine must use a loopback redirect — an address starting with http://localhost. Custom schemes like cursor:// are not accepted, because they cannot be verified as belonging to anyone.

Cursor and VS Code with GitHub Copilot both work this way already: each registers itself with Verdalia automatically and redirects through localhost — Cursor to http://localhost:8787/callback, VS Code to http://127.0.0.1:33418 — which is exactly the loopback rule above. In Cursor, add the address above to your mcp.json file and enable it; in VS Code, run MCP: Add Server from the Command Palette and paste the address when prompted.

How much you can use it

Each account can make 100 connector requests a day on the free plan and 2,000 on Pro, counted across every assistant you connect. Every action your assistant takes counts: each tool call — a lookup, a search, a care log — and each Home Assistant check. Connecting it and listing its tools are free. The tally resets at midnight UTC, and your assistant can ask Verdalia how much is left. If you run out, it will tell you so rather than failing silently.

Withdrawing access

Open Settings › Connected apps in Verdalia. Each connected assistant is listed with where it connects from and when it was last used, and revoking takes effect immediately — the assistant loses access on its very next request.

If something goes wrong

Support and security

Questions, or something not working? Write to support@verdalia.app.

Found a security vulnerability? Please report it privately to support@verdalia.app rather than posting it publicly. Our security contact is also published at /.well-known/security.txt.