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

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.

Submit your tool