PlugWiki
Microsoft Fabric MCP Server logo

Microsoft Fabric MCP Server: Setup for Claude, Cursor and Other Apps

OfficialLocal

Lets your assistant look up Microsoft Fabric APIs, browse OneLake data, manage workspaces and items, and run Data Factory pipelines.

This is Microsoft's server for Fabric. It runs on your computer and gives the assistant bundled Fabric API specs and best practices, plus tools that act on your own Fabric account.

The docs tools only read files that ship with the server. The other tools sign in as you and can create, change and delete real workspaces, items, files and access roles.

Good for

  • Data engineers building Fabric lakehouses, pipelines and notebooks
  • Developers who want an assistant to write correct Fabric API code
  • Fabric admins managing workspaces, capacities and access roles
  • Analysts exploring OneLake files and tables

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install Microsoft Fabric MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Microsoft Fabric MCP server to Claude Code. Run this command:
    
    claude mcp add microsoft-fabric -- npx -y @microsoft/fabric-mcp@latest server start --mode all
    
    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, Node.js 22 or later, A Microsoft Fabric account.

Read-only mode: The README says read-only server mode hides every tool that changes things, but does not name the switch. Run the server with --help to find it, or use a Fabric account that can only read.

Needs Node.js 22 or later. The command ends with server start --mode all, which starts the server with every toolset on. The README also lists a VS Code extension and a Docker image (mcr.microsoft.com/fabric/fabric-mcp), which needs a service principal in an env file because it does not use your az login. Tools that change Fabric use your Fabric permissions, so use an account that can only reach what you want changed.

Built from the package data we hold. Not yet tested by us.

Tools

  • Lists Fabric item types that have API docs

    Shows which Fabric item types, such as lakehouses or notebooks, have bundled API specifications, plus the platform and admin API areas. It reads files that ship with the server.

    Try: “What Fabric item types are available?”

    Read · docs_list-item-types

  • Gets the API spec for one item type

    Gives the assistant the bundled OpenAPI document for one item type, so it can see every operation that type supports. It reads files that ship with the server.

    Try: “Show me the API operations for notebooks.”

    Read · docs_item-api-spec

  • Gets the core Fabric platform API spec

    Hands the assistant the bundled OpenAPI document for the platform-level Fabric APIs, so it can write calls against them.

    Try: “Get the platform API specification for Fabric.”

    Read · docs_platform-api-spec

  • Gets the JSON schema for an item type

    Returns the schema that describes how a Fabric item type is defined, so the assistant can write valid definitions.

    Try: “Show the JSON schema for a data pipeline item.”

    Read · docs_item-definitions

  • Reads Fabric best practices

    Returns guidance on a topic such as throttling, pagination or error handling.

    Try: “How should I handle API throttling in Fabric?”

    Read · docs_best-practices

  • Gets example API calls

    Fetches sample request and response bodies for one item type, so the assistant can copy the shape of a valid call.

    Try: “Show an example payload for creating a notebook.”

    Read · docs_api-examples

  • Lists your Fabric workspaces

    Returns one page of workspaces you can reach, optionally filtered by your role, with a token for the next page.

    Try: “List the Fabric workspaces where I am an Admin.”

    Network · core_list-workspaces

  • Shows one workspace

    Looks up one workspace by its ID and returns details such as capacity, domain and endpoints. Nothing inside the workspace is read or changed.

    Try: “Get the details of this workspace.”

    Network · core_get-workspace

  • Creates a workspace

    Makes a new workspace, and can attach a capacity and a domain in the same call. It never retries by itself, so check whether the workspace exists before asking again after a failure.

    Try: “Create a workspace called Sales Planning.”

    Write · core_create-workspace

  • Renames a workspace or edits its description

    Edits the name or the description of a workspace by its ID. Anything you leave out stays as it was. You need the Admin role on the workspace.

    Try: “Rename this workspace to Capacity Analytics.”

    Write · core_update-workspace

  • Deletes a workspace and everything in it

    Removes one workspace by ID together with the items under it. Needs workspace Admin access and is marked destructive.

    Try: “Delete the old test workspace.”

    Delete · core_delete-workspace

  • Moves a workspace to a capacity

    Asks Fabric to put a workspace on a capacity. The answer only says the request was accepted, so check the workspace afterwards.

    Try: “Assign this workspace to capacity X.”

    Write · core_assign-workspace-to-capacity

Read from the source code

Permissions

high risk · 4 things to watch

High risk

The docs tools are harmless, but the other tools can create, change and delete real Fabric workspaces, items and OneLake files. Use an account or service principal with only the Fabric permissions you want the assistant to have.

What it can do

Watch out for

  • It can delete workspaces, items and files

    Tools delete whole workspaces with everything in them, items, OneLake files and folders, access roles and shortcuts. Review each request and use a limited account. github.com

  • It can change who can read your data

    One tool creates or edits OneLake data access roles. Use an identity that cannot change security settings if you do not need it. github.com

  • Microsoft collects usage data

    The README says the software may collect usage information and send it to Microsoft, and points to the repository for how to turn it off. github.com

  • Item definitions may include secrets

    A tool that reads a full item definition is described on the main branch but is not in the published 1.6.0 package. Where it exists, the README says it asks for consent first. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyThe README says a read-only server mode hides and rejects every tool that changes things, including the delete tools. The Fabric docs do not show the flag. The server's start options in the 1.6.0 source include a read-only option, so check `npx -y @microsoft/fabric-mcp@latest server start --help` for its exact name.
Talks toMicrosoft Fabric and OneLake APIs
Sign-in and keysOperational tools use the identity configured for the server. The Docker image needs a service principal in an env file and does not use your az login.
Scopes
  • Whatever Fabric permissions the signed-in identity has

Questions

Is the Fabric MCP server official?

Yes. Microsoft publishes it from its microsoft/mcp repository.

Does it need a Fabric account?

The docs tools work without one because they read bundled files. All other tools need an identity with Fabric permissions, and they only reach what that identity can reach.

Can it delete my data?

Yes. It can delete workspaces with their contents, items, OneLake files and folders, shortcuts and access roles. Use a limited account.

Can I make it read-only?

The README says a read-only server mode exists and hides the tools that change things, but the Fabric docs do not name the switch. Run the server with server start --help to find it.

How do I use it in VS Code?

Install the Fabric MCP Server extension from the VS Code Marketplace, or use the install box on this page. The extension has a setting to turn toolsets on or off.

How many tools does it have?

62 in the published @microsoft/fabric-mcp 1.6.0: 16 core, 7 Data Factory, 6 docs and 33 OneLake. The main branch of the repository describes more that are not published yet.

Does it run in Docker?

Yes. The README lists the image mcr.microsoft.com/fabric/fabric-mcp. The container does not use your az login, so give it a service principal through an env file.

Does it run locally or in the cloud?

Locally. The docs tools read files on your computer, and the other tools call Fabric APIs under your identity.

Information

updated Nov 2, 2026

Publisher
Official
Package
@microsoft/fabric-mcp
Registry
npm
Transport
stdio
Version
1.4.0
License
MIT
Last commit
Oct 30, 2026
Open issues
231
Listed in
Official MCP registry

GitHubnpmOfficial MCP Registry

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. CHANGELOG.md · github.com
  2. README.md · github.com

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