Installation¶

microsoft-agent is a standard Python package and a prebuilt container image. Pick the path that matches how you want to run it.

Requirements¶

Python 3.11 – 3.14.
A registered Microsoft Entra ID (Azure AD) application with Microsoft Graph permissions, and its client id / client secret. Microsoft 365 is a managed service — see the Backing Service note for configuration.

From PyPI (recommended)¶

pip install microsoft-agent

Optional extras¶

The base install is intentionally minimal. Install the extra for what you need:

Extra	Install	Pulls in
`mcp`	`pip install "microsoft-agent[mcp]"`	FastMCP MCP-server runtime (`agent-utilities[mcp]`)
`agent`	`pip install "microsoft-agent[agent]"`	Pydantic-AI A2A agent + Logfire tracing
`all`	`pip install "microsoft-agent[all]"`	MCP server, agent, and Logfire — everything above
`test`	`pip install "microsoft-agent[test]"`	`pytest`, `pytest-asyncio`, `pytest-cov`

# Typical: run the MCP server and the A2A agent together
pip install "microsoft-agent[all]"

From source¶

git clone https://github.com/Knuckles-Team/microsoft-agent.git
cd microsoft-agent
pip install -e ".[all]"          # editable install with every extra

With uv:

uv pip install -e ".[all]"
uv run microsoft-mcp

Prebuilt Docker image¶

A multi-stage, slim image is published on every release (installs microsoft-agent[all], console scripts microsoft-mcp and microsoft-agent):

docker pull knucklessg1/microsoft-agent:latest

docker run --rm -i \
  -e MICROSOFT_CLIENT_ID=your-app-registration-client-id \
  -e MICROSOFT_CLIENT_SECRET=your-client-secret \
  -e MICROSOFT_SCOPE=https://graph.microsoft.com/.default \
  knucklessg1/microsoft-agent:latest        # stdio transport (default)

For an HTTP server with a published port and the A2A agent, see Deployment.

Verify the install¶

microsoft-mcp --help
microsoft-agent --help
python -c "import microsoft_agent; print(microsoft_agent.__version__)"

Next steps¶

Deployment — run it as a long-lived MCP server and A2A agent behind Caddy + DNS.
Usage — call the tools, the API, and the CLI.
Configuration — every environment variable.