The runtime for Micro, a personal assistant.
A place to view and do things e.g prompt, see what's happening, etc.
Connect from various places and it all goes in one inbox.
| Protocol | Info |
|---|---|
| HTTP | Start a conversation or reopen one from Inbox. |
| SMTP | Send a message to agent@your-domain from your verified email address |
| SMS | Verify your phone number in Account, then text the configured number. |
| Use your verified number to message the configured WhatsApp sender. | |
| XMPP | Connect with your account and a Chat token from Client access, then message the agent. |
Micro is the default agent. Agents have instructions and a permitted set of tools. Services provide those tools: mail, files, calendar, search, weather, notes, shell, and more. You ask for an outcome; the agent chooses the tools.
Work can run in the background and return its result to the originating conversation. Task records live in service/tasks. Agents own the daily brief and delivery logic, while service/events schedules it and Work tracks each occurrence.
Complete standalone services that agents can use as tools or you can browse with. For example a complete Mail client and server. Web search via brave. News aggregation, headlines and summary via RSS. Video search via YouTube. All behind one MCP interface.
curl -fsSL https://raw.githubusercontent.com/micro/mu/main/install.sh | sh
mu setup
mu --serveOpen http://localhost:8080. Initial administrator setup depends on the instance's bootstrap configuration; see the installation guide.
Configure an AI provider with mu setup, or use the settings below.
From source:
git clone https://github.com/micro/mu
cd mu
go install
mu setup
mu --serveOr run docker compose up from the checkout. See the
installation guide for domains, TLS, mail, messaging,
sandbox configuration, and deployment.
The binary acts as a client. It defaults to the hosted instance; set
MU_URL or use mu login https://your.host for your own server.
mu ask "What needs my attention?"
mu inbox list
mu helpcurl "$MU_URL/agent" \
-H "Authorization: Bearer $MU_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"prompt":"What needs my attention?"}'The response includes text and thread; send the thread identifier
back to continue. Requests and credentials belong in request bodies and headers.
A separately configured x402 host provides paid service calls.