# d365fo-client

> A comprehensive Python client library and MCP server for Microsoft Dynamics 365 Finance & Operations (D365 F&O) that provides easy access to OData endpoints, metadata operations, label management, and

- **URL**: https://www.freshcrate.ai/projects/d365fo-client
- **Author**: mafzaal
- **Category**: MCP Servers
- **Latest version**: `v0.3.7` (2026-04-18)
- **License**: MIT
- **Source**: https://github.com/mafzaal/d365fo-client
- **Homepage**: https://thedataguy.pro/d365fo-client/
- **Language**: Python
- **GitHub**: 28 stars, 13 forks
- **Registry**: github
- **Tags**: `d365fo`, `d365tools`, `mcp-server`, `python`

## Description

A comprehensive Python client library and MCP server for Microsoft Dynamics 365 Finance & Operations (D365 F&O) that provides easy access to OData endpoints, metadata operations, label management, and AI assistant integration.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.3.7` | 2026-04-18 | High | ## What's Changed * ci(deps): Bump actions/checkout from 5 to 6 by @dependabot[bot] in https://github.com/mafzaal/d365fo-client/pull/90 * deps(deps): Bump mcp from 1.21.1 to 1.22.0 by @dependabot[bot] in https://github.com/mafzaal/d365fo-client/pull/91 * deps(deps): Bump ruff from 0.14.5 to 0.14.6 by @dependabot[bot] in https://github.com/mafzaal/d365fo-client/pull/92 * deps(deps): Bump black from 25.11.0 to 25.12.0 by @dependabot[bot] in https://github.com/mafzaal/d365fo-client/pull/93 * d |
| `v0.3.6` | 2025-11-23 | Low | ## v0.3.6 - 2025-11-23  ### Added - **MCP Server Definition**: Added official MCP server definition file (server.json) for enhanced discoverability   - Comprehensive server metadata including name, description, title, website, and repository information   - Package registry configurations for both PyPI (uvx) and OCI (Docker) installation methods   - Environment variable definitions with security and requirement specifications   - Runtime arguments configuration for Docker deployment - ** |
| `v0.3.5` | 2025-11-22 | Low | ## v0.3.5 - 2025-11-22  ### Added - **Cross-Company Query Support**: Automatic cross-company query handling for dataAreaId filtering   - Automatically adds `cross-company=true` parameter when filter contains dataAreaId   - Cross-company support for composite keys with dataAreaId   - New unit tests for cross-company key handling and query building   - Demo examples showcasing cross-company query functionality  ### Improved - **Test Suite Organization**: Major refactoring and cleanup of |
| `v0.3.4` | 2025-10-26 | Low | ## v0.3.4 - 2025-10-26  ### Added - **SRS Report Download Tools**: New comprehensive MCP tools for downloading various report types from D365 Finance & Operations   - `d365fo_download_customer_invoice` tool for customer invoice PDFs   - `d365fo_download_free_text_invoice` tool for free text invoice PDFs   - `d365fo_download_debit_credit_note` tool for credit/debit note PDFs   - `d365fo_download_sales_confirmation` tool for sales confirmation PDFs   - `d365fo_download_purchase_order` tool |
| `v0.3.3` | 2025-10-19 | Low | ## v0.3.3 - 2025-10-19  ### Fixed - **OData Key Formatting**: Fixed OData date/time key formatting for D365 F&O compatibility   - **BREAKING**: Date/time types in OData keys no longer use quotes (aligns with D365 F&O OData spec)   - OData queries with date/time keys now work correctly with D365 F&O   - Enhanced test coverage with comprehensive mock support for session manager - **Docker Deployment**: Updated deployment script to use 'latest' Docker image tag - **Docker Build**: Updated D |
| `v0.3.2` | 2025-10-12 | Low | ## v0.3.2 - 2025-10-12  ### Added - **JSON Service Tools**: New MCP tools for calling D365 F&O JSON services   - `d365fo_call_json_service` tool for generic JSON service operations   - `d365fo_call_sql_diagnostic_service` tool for SQL diagnostic operations   - JsonServiceRequest and JsonServiceResponse models for structured requests   - Comprehensive examples in `examples/json_service_examples.py` - **Enhanced QueryBuilder**: Advanced OData query building with schema awareness   - Autom |
| `v0.3.1` | 2025-10-02 | Low | ## [0.3.1] - 2025-10-01  ### Added - **API Key Authentication Provider**: New authentication provider for MCP server   - Added auth/providers/apikey.py for secure API key validation   - Enhanced fastmcp_main.py with API key authentication support   - Comprehensive test suite for API key functionality   - Integration and unit tests for secure authentication flow  ### Fixed - **Azure OAuth Provider Client Persistence**: Resolved serialization and reliability issues   - Fixed OAuthClient |
| `v0.3.0` | 2025-09-30 | Low | ## [0.3.0] - 2025-09-29  ### Added - **Pydantic Settings Model**: Comprehensive environment variable management with type safety and validation   - Added D365FOSettings class with support for 35+ environment variables   - Automatic type conversion and validation with pydantic-settings>=2.6.0   - Support for .env files and IDE IntelliSense   - Utility methods: has_client_credentials(), get_startup_mode() - **Custom Log File Support**: D365FO_LOG_FILE environment variable for custom log fi |
| `v0.2.4` | 2025-09-21 | Low | ### Added - **Docker Support**: Added containerization support for d365fo-client package   - Added `.dockerignore` file with comprehensive exclusion patterns for clean Docker builds   - Added `Dockerfile` with multi-stage build process optimized for production deployment   - Added GitHub workflow for automated Docker image building and publishing to GitHub Container Registry  ### Documentation - **Comprehensive MCP Tools Guide**: Added detailed introduction to MCP tools with usage example |
| `v0.2.3` | 2025-08-31 | Low | ## [0.2.3] - 2025-08-31  ### Added - **Enhanced Credential Management**: Complete credential source management system for D365 F&O client authentication   - Added `CredentialSource`, `EnvironmentCredentialSource`, and `KeyVaultCredentialSource` classes for managing different credential sources   - Implemented `CredentialProvider` interface with `EnvironmentCredentialProvider` and `KeyVaultCredentialProvider` for retrieving credentials   - Introduced `CredentialManager` to handle credential |

## Citation

- HTML: https://www.freshcrate.ai/projects/d365fo-client
- Markdown: https://www.freshcrate.ai/projects/d365fo-client.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/d365fo-client/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._