🏢 Microsoft Dynamics 365 Business Central MCP Server

A MCP Server for Microsoft Dynamics 365 Business Central with OAuth2 authentication and API v2.0 endpoints. Built by Dmitry Katson, Microsoft AI & Business Central MVP, enabling AI agents to seamlessly interact with Business Central data.

Please note that this project is actively maintained and may receive updates to enhance functionality and compatibility.

�� Table of Contents

1. 🎯 Overview
2. 🛠️ Currently Supported Tools
3. 🔌 Installation & Getting Started
4. ⚙️ Configuration
5. ❓ Troubleshooting
6. 📚 Additional Resources
7. 👨‍💻 Author
8. 📄 License

🎯 Overview

✨ Example Prompts: Your Business Central Assistant

Your AI assistant can seamlessly interact with your Business Central environment using these advanced tools. Try asking questions like:

• "List all open purchase orders for the last month"
• "Which customers have not placed an order in the past 90 days?"
• "Show me the top 5 selling items by revenue this quarter"
• "What are the outstanding vendor invoices over $10,000?"
• "Find all sales orders awaiting shipment"
• "Which items are below their reorder point?"
• "Get the approval status of all posted purchase invoices"

Everything exposed by your Business Central APIs—whether standard or custom—is accessible through this MCP server.

📊 Key Capabilities

• 🔐 OAuth2 Authentication: Secure Azure AD integration with Business Central
• 🏢 Auto Company Discovery: Automatic company detection and switching
• 📊 Full CRUD Operations: Complete entity management capabilities
• 🔍 Schema Discovery: Dynamic field and relationship exploration
• ⚡ API v2.0: Latest Business Central OData endpoints
• 🧩 Clean Architecture: Professional, scalable, and maintainable design

🛠️ Currently Supported Tools

🔌 Installation & Getting Started

The Business Central MCP Server supports installation across multiple clients. Choose your preferred client below for streamlined setup.

▶️ Getting Started

Follow these steps to get your Business Central MCP Server up and running:

1. 📦 Install Python & Package

   • Ensure Python 3.8+ is installed on your system
   • Install the MCP server: see installation commands
   • Verify installation works: verification steps

2. 🔐 Set up Azure Authentication

   • Create Azure AD app registration: detailed Azure setup
   • Configure Business Central API permissions
   • Generate client secret and note required values

3. 🔧 Add to Your MCP Client

   • Configure your preferred client: client configuration table

4. 🚀 Test the Connection

   • Restart your MCP client completely for changes to take effect
   • Try example prompts:
     • "Show me all customers from Business Central"
     • "List available Business Central entities"
     • "What companies are available in my Business Central environment?"
   • Explore common Business Central entities like customers, vendors, items, and sales orders

💡 Tip: Once connected, you can ask about any Business Central entity or use natural language to query your business data!

Need help? Check our troubleshooting section for common issues and solutions.

📦 Installation

Prerequisites

Python 3.8+ Required - The MCP server requires Python to be installed on your system.

python --version
pip --version

python -m pip --version

brew install python

sudo apt update
sudo apt install python3 python3-pip

sudo yum install python3 python3-pip

sudo pacman -S python python-pip

Install MCP Business Central

Once Python is installed, install the MCP server:

# Windows
pip install mcp-business-central
# or if pip is not in PATH:
python -m pip install mcp-business-central

# macOS/Linux  
pip3 install mcp-business-central
# or
python3 -m pip install mcp-business-central

Verify Installation

# Windows
python -m mcp_business_central --help

# macOS/Linux
python3 -m mcp_business_central --help

⚙️ Configuration

🔐 Azure AD Setup

1. Create Azure AD App Registration

   • Navigate to Azure Portal → Azure Active Directory → App registrations
   • Click "New registration"
   • Provide a meaningful name (e.g., "Business Central MCP Server")

2. Configure API Permissions

   • Go to "API permissions"
   • Add permission → Microsoft APIs → Dynamics 365 Business Central
   • Select Financials.ReadWrite.All (Application permission)
   • Grant admin consent for your organization

3. Create Client Secret

   • Go to "Certificates & secrets"
   • Click "New client secret"
   • Copy the secret value (you won't see it again!)

4. Note Required Values

   • Application (client) ID
   • Directory (tenant) ID
   • Client secret value

🔧 Client Configuration

{
  "mcpServers": {
    "businesscentral": {
      "command": "python3",
      "args": ["-m", "mcp_business_central"],
      "env": {
        "BC_TENANT_ID": "your-tenant-id",
        "BC_CLIENT_ID": "your-client-id",
        "BC_CLIENT_SECRET": "your-client-secret",
        "BC_ENVIRONMENT": "production"
      }
    }
  }
}

{
  "mcpServers": {
    "businesscentral": {
      "command": "python",
      "args": ["-m", "mcp_business_central"],
      "env": {
        "BC_TENANT_ID": "your-tenant-id",
        "BC_CLIENT_ID": "your-client-id",
        "BC_CLIENT_SECRET": "your-client-secret",
        "BC_ENVIRONMENT": "production"
      }
    }
  }
}

{
  "businesscentral": {
    "command": "python3",
    "args": ["-m", "mcp_business_central"],
    "env": {
      "BC_TENANT_ID": "your-tenant-id",
      "BC_CLIENT_ID": "your-client-id",
      "BC_CLIENT_SECRET": "your-client-secret",
      "BC_ENVIRONMENT": "production"
    }
  }
}

{
  "businesscentral": {
    "command": "python3",
    "args": ["-m", "mcp_business_central"],
    "env": {
      "BC_TENANT_ID": "your-tenant-id",
      "BC_CLIENT_ID": "your-client-id",
      "BC_CLIENT_SECRET": "your-client-secret",
      "BC_ENVIRONMENT": "production"
    }
  }
}

{
  "businesscentral": {
    "command": "python3",
    "args": ["-m", "mcp_business_central"],
    "env": {
      "BC_TENANT_ID": "your-tenant-id",
      "BC_CLIENT_ID": "your-client-id",
      "BC_CLIENT_SECRET": "your-client-secret",
      "BC_ENVIRONMENT": "production"
    }
  }
}

❓ Troubleshooting

💻 System Prompt

For optimal tool usage, add this system prompt to encourage your AI assistant to use Business Central tools:

## Business Central Integration

You have access to MCP tools for Microsoft Dynamics 365 Business Central. These tools allow you to:
- Query customer, vendor, and item data
- Access financial information and sales orders
- Explore entity schemas and relationships
- Manage company contexts

When handling questions about business data, ERP operations, or financial information, use these Business Central tools to provide accurate, real-time information from the user's Business Central environment.

⚠️ Common Issues

🆘 Getting Support

• Create an issue
• Join discussions
• Contact the author

📚 Additional Resources

• Microsoft Dynamics 365 Business Central Documentation
• Business Central Web API Reference
• Model Context Protocol Specification
• Azure AD App Registration Guide

👨‍💻 Author

Dmitry Katson - GitHub | Website

🏆 Microsoft AI & Business Central MVP
🏆 Contribution Hero 2024
🌐 Creator of CentralQ.ai - AI search for Business Central community

📄 License

MIT License - Copyright (c) 2025 Dmitry Katson