PlugWiki
Power BI Authoring MCP Server (Local) logo

Power BI Authoring MCP Server: Setup for Claude, Cursor and VS Code

OfficialLocal
Getnpm@microsoft/powerbi-modeling-mcpmicrosoft/powerbi-modeling-mcp/tree/HEAD/clients/node

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.

Install Power BI Authoring MCP Server (Local)

Claude Code

  1. 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. 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_operations

  • Manages 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_operations

  • Reads 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_operations

  • Manages 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_operations

  • Manages table columns

    Gets, lists, creates, updates, renames and deletes columns.

    Try: “Add a "Margin %" column to the Sales table.”

    Delete · column_operations

  • Manages 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_operations

  • Manages 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_operations

  • Runs 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_operations

  • Groups 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_operations

  • Captures 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_operations

  • Manages table partitions

    Creates, updates, deletes and refreshes individual partitions of a table.

    Try: “Refresh only the 2026 partition of the Sales table.”

    Delete · partition_operations

  • Manages 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_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

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-onlyStart the server with the --readonly flag. The default is --readwrite, which asks you to confirm before the first edit to each database.
Talks toPower BI / Fabric XMLA endpoints. Microsoft (the README says the software may collect usage data)
Sign-in and keysSign-in goes through the Azure Identity SDK. The README says the server never stores or manages tokens itself.
Scopes
  • Write permission on the semantic model

  • Microsoft Entra sign-in or service principal

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

GitHubnpmOfficial MCP RegistryChangelogIssues

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 2
  1. Power BI Authoring MCP README · github.com
  2. Power BI Authoring MCP EULA · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.