Tool plugins

Teach your mushroom new tricks.

A tool plugin is one small JSON file that teaches Mushroom's chat a new trick: a cat fact, a word lookup, your own API. Download a tool below, import it in Settings → Tools (or drop it into the tools folder), and just ask the pet.

Plugins are plain https calls. They can never run programs or touch your files, and personal values like API keys stay on your Mac, stripped whenever a tool is exported.

Gallery

advice

Fetches one short piece of everyday life advice. Use when the person asks for advice or a random tip.

Download advice.json

airQuality

Gets the current air quality where the person lives, on the US AQI scale that most air quality sites show (0 to 50 is good, 51 to 100 moderate, over 100 unhealthy). Use when they ask about air quality, smog, pollution, or whether it is a good day to be outside.

Download airQuality.json

catFact

Fetches a random cat fact. Use when the person asks about cats or wants a fun fact.

Download catFact.json

dadJoke

Fetches a random dad joke. Use when the person asks for a joke or could use a laugh.

Download dadJoke.json

defineWord

Looks up the definition of an English word. Use when the person asks what a word means.

Download defineWord.json

dinnerIdea

Suggests a random dish to cook. Use when the person wonders what to cook or eat today.

Download dinnerIdea.json

exchangeRate

Converts an amount of money from one currency to another and returns the converted amount, already worked out. Use when the person asks what an amount in one currency is worth in another, e.g. 3 euros in dollars.

Download exchangeRate.json

nextHoliday

Gets the DATE of the next public holiday in a country, as YYYY-MM-DD. It returns the date and nothing else, so state the date and never guess which holiday it is. Use when the person asks when the next holiday or day off is.

Download nextHoliday.json

spacePicture

Gets a link to today's NASA astronomy picture of the day. Returns a URL, so pass it along as it is. Use when the person asks about space, the sky, or wants something pretty to look at.

Download spacePicture.json

sunset

Gets today's sunset time where the person lives, in their own local time. Use when they ask when the sun sets or how much daylight is left.

Download sunset.json

wikiFact

Looks up a short Wikipedia summary of a topic. Use when the person asks a factual question about a person, place, or thing.

Download wikiFact.json

More coming. Made one you like? Send it in below.

Write your own

It really is just one file. This is the whole cat-fact tool:

{
  "name": "catFact",
  "description": "Fetches a random cat fact. Use when the person asks about cats or wants a fun fact.",
  "url": "https://catfact.ninja/fact",
  "extract": "fact"
}

Tips: keep the description short and specific ("Use when the person asks X"), always set extract so the pet gets one clean string, and make two small tools rather than one clever one. Mushroom carries at most 4 enabled tools at a time.

Submit your tool

We review every tool by hand before it appears in the gallery. Please do not put API keys or personal values in the file, use a {{placeholder}} instead.