A local AI automation assistant that acts as a personal NAS for notes, files, reminders and memory, and exposes 40+ tools to AI clients via MCP.
micro/mu
An open-source personal AI assistant runtime in Go that takes requests over email, SMS, XMPP, and HTTP and acts through tools like mail, calendar, and files.
- Stars
- 437
- Forks
- 22
- Open issues
- 61
- Last commit
- 1 hour ago
What is it?
Mu is the runtime behind Micro, a self-hostable personal assistant. Messages from HTTP, SMTP email, SMS, and XMPP all land in a single inbox, and you can ask the agent for an outcome in plain language. The default agent, Micro, has instructions and a set of tools provided by services such as mail, files, calendar, search, weather, notes, and shell.
Services can run as standalone components you browse directly, or as tools the agent calls. Examples include a complete mail client and server, Brave web search, RSS news aggregation with summaries, and YouTube video search. All of them are exposed through one MCP interface.
The binary also works as a CLI client pointed at the hosted instance or your own server, and the HTTP API accepts bearer-token requests and returns a thread identifier so conversations can continue.
Key features
- 01Receives requests over HTTP, SMTP email, SMS, and XMPP in one inbox.
- 02Agents choose tools from services for mail, files, calendar, search, and more.
- 03Exposes services through a single MCP interface.
- 04Provides a CLI with commands such as ask and inbox list.
- 05Offers an HTTP API that returns thread identifiers for continued conversations.
Use cases
- Running a self-hosted personal assistant that handles email and calendar tasks.
- Asking an agent to summarize news or search the web from a terminal.
- Integrating an AI agent into scripts through its HTTP API.
Quick start
- 1
Run the official install script from the README
- 2
Start the server on localhost
~/.local/bin/mu --serve --address 127.0.0.1:8080 - 3
Open the web page to create your account and choose an AI provider
Things to know
- Licensed under AGPL-3.0, a copyleft license that requires source disclosure for modified network-served versions.
- You must choose and configure an AI provider during setup before the assistant can respond.
- Self-hosting requires following the separate install and configuration documentation.
Topics
FAQ
- What is mu?
- An open-source personal AI assistant runtime in Go that takes requests over email, SMS, XMPP, and HTTP and acts through tools like mail, calendar, and files. Mu is the runtime behind Micro, a self-hostable personal assistant. Messages from HTTP, SMTP email, SMS, and XMPP all land in a single inbox, and you can ask the agent for an outcome in plain language. The default agent, Micro, has instructions and a set of tools provided by services such as mail, files, calendar, search, weather, notes, and shell.
- Is mu free to use? What license does it have?
- mu is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
- Is mu still maintained?
- Actively maintained. The last commit to mu was on Oct 22, 2026.
- What can I use mu for?
- Running a self-hosted personal assistant that handles email and calendar tasks. Asking an agent to summarize news or search the web from a terminal. Integrating an AI agent into scripts through its HTTP API.
- How do I install mu?
- Run the official install script from the README Start the server on localhost: ~/.local/bin/mu --serve --address 127.0.0.1:8080 Open the web page to create your account and choose an AI provider
- Where can I get mu?
- The source code and installation instructions are on GitHub: https://github.com/micro/mu
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A local-first desktop AI assistant with long-term memory, autonomous goals, dynamic workflows, and a headless server mode for NAS or cloud hosts.
Open-source, sessionless personal AI agent that turns goals into Tasks and keeps working on them across devices, with self-hosting via Docker Compose.
Command-line client for a personal muse.ai AI agent: chat, side chats, feed, goals, ideas and sessions from the terminal.
Open-source personal AI agent and voice assistant with a dual-brain design, personal memory, and delegation to coding agents.
A local-first AI workspace for multi-agent chat, coding agents, and visual workflows, as a desktop app or self-hosted web console.