---
id: microsoft-agents-copilotstudio-client
version: "1.3.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# microsoft-agents-copilotstudio-client — A client library for Microsoft Agents

License: permissive · Maintenance: active · Downloads: 465.0K/mo

## What it is and what it does

This package is a Python client for connecting to and interacting with AI agents built in Microsoft Copilot Studio. It bypasses traditional chat channels and provides a direct connection to agents, making it suitable for integrating conversational AI into custom applications, building specialized UIs, or enabling agent-to-agent communication flows. The library is part of the broader Microsoft 365 Agents SDK and handles authentication, connection configuration, and message exchange with Copilot Studio agents.

The client supports multiple connection modes: environment-based configuration using credentials and agent identifiers, or simplified DirectConnect URL mode for streamlined setup. It includes optional diagnostic logging for HTTP communication inspection and experimental endpoint support for pre-release features. The package requires Python 3.10 or later and depends on microsoft-agents-hosting-core for core hosting functionality.

Use it for:

- Embed Copilot Studio agents into custom Python web applications or desktop tools without using Teams or web chat interfaces
- Build agent-to-agent communication flows where one Python service orchestrates interactions with multiple Copilot Studio agents
- Create specialized user interfaces that interact with Copilot Studio agents while maintaining full control over conversation state and presentation
- Integrate enterprise AI agents into backend services or data processing pipelines for automated decision-making or content generation
- Enable diagnostic inspection of agent communication for debugging, monitoring, or compliance logging

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Connects Python applications to AI agents created in Microsoft Copilot Studio, enabling direct interaction with agents without traditional chat channel intermediaries.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive MIT license, and provides a straightforward way to integrate Copilot Studio agents into Python applications. Install it if you need direct programmatic access to Copilot Studio agents outside traditional chat channels. The single runtime dependency and low install friction make adoption low-risk.

## Install

pip install microsoft-agents-copilotstudio-client
uv add microsoft-agents-copilotstudio-client
poetry add microsoft-agents-copilotstudio-client

## Installing microsoft-agents-copilotstudio-client

Before you install: Active maintenance with recent release (15 days old), supports Python 3.10–3.14, and depends on a single runtime package (microsoft-agents-hosting-core) with low install friction.

License in practice: MIT license permits commercial and private use, modification, and distribution with minimal restrictions—suitable for most enterprise and open-source projects.

Quickstart:

pip install microsoft-agents-copilotstudio-client

from microsoft_agents_copilotstudio_client import CopilotClient, ConnectionSettings

settings = ConnectionSettings(
    environment_id="your-env-id",
    agent_identifier="your-agent-id"
)
client = CopilotClient(settings, token)

Requires Python 3.10 or later; authentication token and valid Copilot Studio environment/agent identifiers must be obtained separately (typically via MSAL or Entra ID).

Verify before relying:

- Whether the package requires Azure/Microsoft 365 credentials or service subscriptions beyond what the documentation shows
- Performance characteristics and latency expectations for agent communication at scale
- Backward compatibility guarantees across minor versions

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 465.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

copilot studio agent client, microsoft agents python sdk, copilot studio integration, direct agent connection, conversational ai client, microsoft 365 agents, agent-to-application communication, conversational-ai, microsoft-ecosystem, agent-framework

[View on SkillFed](https://skillfed.io/packages/microsoft-agents-copilotstudio-client) · [View on PyPI](https://pypi.org/project/microsoft-agents-copilotstudio-client/)