
Power BI Authoring MCP Server: Setup for Claude, Cursor and VS Code
Lets your AI assistant build and change Power BI semantic models: tables, measures, relationships, security roles and DAX queries.
It runs on your computer and talks to the model through your own Microsoft sign-in, or a service principal if you set one. It edits models in Power BI Desktop, Fabric workspaces and PBIP files, but not report pages. You must accept Microsoft's license terms before any tool works, and you should back up the model first.
Good for
- Power BI developers who want to bulk rename, document or translate a model by chat
- Analysts who want DAX written, run and checked against a real model
- Teams that keep models as PBIP or TMDL files in source control
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install Power BI Authoring MCP Server (Local)
Claude Code
- 1
Copy this prompt.
Add the Power BI Authoring MCP Server (Local) server to Claude Code. Run this command: claude mcp add power-bi-authoring-local -- npx -y @microsoft/powerbi-modeling-mcp@latest --start Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Node.js.
Read-only mode: Add `--readonly` to the server arguments. The default `--readwrite` mode asks for confirmation before the first edit to each database.
The server only starts with --start, so the config below adds it. Before any tool works you must accept Microsoft's EULA: ask your assistant to call the accept tool after you approve, or add --accepteula (or set PBI_MODELING_MCP_ACCEPT_EULA to true) once you have read it. For Power BI Desktop models run it on Windows with Desktop open; Fabric and PBIP models can be reached from other systems. Microsoft recommends its hosted Power BI Authoring MCP server for Fabric workspaces; the README links to its Microsoft Learn page. The @latest --start arguments come from the README's npx example, which names no client, so other clients' configs are adapted from it.
Built from the package data we hold. Not yet tested by us.
Tools
Connects to a Power BI model
Opens a connection to a model in Power BI Desktop or a Fabric workspace. Every other tool works on the model you connect to first.
Try: “Connect to Sales.pbix in Power BI Desktop.”
Network ·
connection_operationsManages whole semantic models
Lists, creates and updates semantic models, imports or exports them as TMDL folders, and deploys to Fabric.
Try: “Export my open model to a TMDL folder and deploy it to the Finance workspace.”
Write ·
database_operationsReads and edits model-level settings
Gets model details and stats, renames or updates the model and refreshes it.
Try: “Show me the size and stats of this model.”
Write ·
model_operationsManages tables
Gets, lists, creates, updates, renames, refreshes and deletes tables in the model.
Try: “List all tables and rename "tbl_Sales" to "Sales".”
Delete ·
table_operationsManages table columns
Gets, lists, creates, updates, renames and deletes columns.
Try: “Add a "Margin %" column to the Sales table.”
Delete ·
column_operationsManages DAX measures
Gets, lists, creates, updates, renames, moves and deletes measures, including their DAX code.
Try: “Create a measure for year-to-date revenue in the Sales table.”
Delete ·
measure_operationsManages table relationships
Creates, updates, activates, deactivates, finds and deletes relationships between tables.
Try: “Find tables with no relationship and connect Orders to Customers.”
Delete ·
relationship_operationsRuns and checks DAX queries
Runs a DAX query against the connected model or validates it, which helps test measures and calculations.
Try: “Run a DAX query that returns the top 10 products by revenue.”
Network ·
dax_query_operationsGroups edits so they can be undone
Begins, commits or rolls back a transaction and reports its state, so a batch of edits applies as one.
Try: “Start a transaction, apply the renames, then show me before you commit.”
Write ·
transaction_operationsCaptures model engine events
Starts and reads a trace of Analysis Services events, useful for seeing how a query or refresh behaves.
Try: “Trace this query and tell me where the time goes.”
Network ·
trace_operationsManages table partitions
Creates, updates, deletes and refreshes individual partitions of a table.
Try: “Refresh only the 2026 partition of the Sales table.”
Delete ·
partition_operationsManages hierarchies
Creates, updates and deletes user hierarchies and their levels, and reorders the levels.
Try: “Create a Date hierarchy with Year, Quarter and Month.”
Delete ·
user_hierarchy_operationsManages calculation groups
Creates and edits calculation groups and their items, such as time intelligence variants.
Try: “Turn my 6M and 12M average measures into a calculation group.”
Delete ·
calculation_group_operationsManages security roles
Configures roles and their row-level security table filters.
Try: “Add a role that only sees rows for the user's own region.”
Delete ·
security_role_operationsManages perspectives
Creates and edits perspectives, which are focused views of the model for different audiences.
Try: “Create a Finance perspective with only the finance tables.”
Delete ·
perspective_operationsManages Power Query parameters
Gets, lists, creates, updates, renames and deletes named expressions and Power Query parameters.
Try: “Create a parameter that switches the data source folder.”
Delete ·
named_expression_operationsManages DAX user-defined functions
Creates, edits and deletes DAX user-defined functions in the model.
Try: “Create a reusable function for safe division.”
Delete ·
function_operationsManages languages
Creates, updates and deletes cultures for multi-language models and lists valid culture names.
Try: “Add French as a language to the model.”
Delete ·
culture_operationsManages translations of model objects
Reads and sets translated names and descriptions of tables, columns and measures in each culture.
Try: “Translate all measure names and descriptions into French.”
Write ·
object_translation_operationsManages calendar tables
Creates and edits calendar objects and their time intelligence column groups.
Try: “Mark the Date table as a calendar with year and month columns.”
Delete ·
calendar_operationsManages Power Query groups
Organises Power Query expressions into query groups.
Try: “Group the staging queries into a folder called Staging.”
Delete ·
query_group_operations
Read from the source code
Permissions
high risk · 4 things to watch
High risk
The assistant can add, change and delete tables, measures, relationships and security roles in the model you connect it to, using your permissions. Start with the read-only flag, take a backup of the model first, and only allow edits once you trust the prompt.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
It can delete tables, columns, measures and roles
Most editing tools include a delete action. Use --readonly first, and back up the model before any change. github.com
Model data can reach your AI provider
Query results and model metadata go to the client and on to the model provider. Avoid sharing chat sessions that contain sensitive data. github.com
It may send usage data to Microsoft
The README says the software may collect information about your use and send it to Microsoft. Check the EULA before using it at work. github.com
Extra connection hosts get your access token
Hosts you add to PBI_MODELING_MCP_ALLOWED_CONNECTION_HOSTS receive your access token when it connects. Add only endpoints you trust. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Start the server with the --readonly flag. The default is --readwrite, which asks you to confirm before the first edit to each database. |
|---|---|
| Talks to | Power BI / Fabric XMLA endpoints. Microsoft (the README says the software may collect usage data) |
| Sign-in and keys | Sign-in goes through the Azure Identity SDK. The README says the server never stores or manages tokens itself. |
| Scopes |
|
Questions
Is the Power BI Authoring MCP server official?
Yes. Microsoft makes and publishes it in the microsoft/powerbi-modeling-mcp repo. Use of it is subject to the Microsoft EULA.
Do I have to accept a license first?
Yes. The server blocks every other tool until you accept the EULA. Your assistant can call the accept tool after you approve, or you can add --accepteula or set PBI_MODELING_MCP_ACCEPT_EULA to true after you have read it.
Does it need `--start`?
Yes. The server only starts when you pass --start in its arguments, so add it to the args of the install config.
Can it run read-only?
Yes. Add --readonly to the arguments and it blocks every write to the model. The default, --readwrite, asks you to confirm before the first edit to each database.
Local or hosted: which should I use?
This page covers the local server. For models in a Fabric workspace the README recommends Microsoft's hosted Power BI Authoring MCP server, which needs no install. Use the local one for Power BI Desktop or PBIP files.
How do I sign in?
The default is a browser sign-in with your Microsoft account. For unattended use, set --authmode=serviceprincipal with AZURE_CLIENT_ID, AZURE_TENANT_ID and either AZURE_CLIENT_SECRET or AZURE_CLIENT_CERTIFICATE_PATH.
Can it change my report pages?
No. It only runs modeling operations, such as tables, measures and relationships. The README says it cannot change report pages or diagram layouts.
Which tools does the list show?
The list follows the tool table in the README. Each tool covers several actions, such as create, update and delete. Microsoft does not publish the server source, so the list cannot be checked against the code.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
@microsoft/powerbi-modeling-mcp- Registry
- npm
- Transport
- stdio
- Auth
- OAuth
- Version
- 1.0.0
- License
- Microsoft EULA
- Last commit
- Sep 29, 2026
- Open issues
- 55
- Listed in
- Official MCP registry
Other Power BI MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- Power BI Authoring MCP README · github.com
- Power BI Authoring MCP EULA · github.com