
Microsoft Fabric MCP Server: Setup for Claude, Cursor and Other Apps
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.
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 Microsoft Fabric MCP
Claude Code
- 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
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-typesGets 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-specGets 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-specGets 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-definitionsReads 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-practicesGets 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-examplesLists 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-workspacesShows 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-workspaceCreates 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-workspaceRenames 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-workspaceDeletes 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-workspaceMoves 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-capacityLists your Fabric capacities
Returns one page of the capacities where you are an administrator or contributor, with SKU, region and state.
Try: “List my Fabric capacities and their SKUs.”
Network ·
core_list-capacitiesShows one capacity
Looks up one capacity by its ID and returns its name, SKU, region and state.
Try: “What state is this capacity in?”
Network ·
core_get-capacityLists items in a workspace
Pages through the items in one workspace or folder, and can limit the list to one item type.
Try: “List the lakehouses in this workspace.”
Network ·
core_list-itemsShows one item's details
Fetches the basic details of one item from its workspace and item IDs. The item's data and definition are not read.
Try: “Show the details of this item.”
Network ·
core_get-itemCreates a Fabric item
Creates an item of a chosen type in a workspace, such as a lakehouse or notebook. It makes a real item when run.
Try: “Create a lakehouse called Sales in this workspace.”
Write ·
core_create-itemRenames an item or edits its description
Renames an item or edits its description, then shows the updated details.
Try: “Rename this notebook.”
Write ·
core_update-itemDeletes a Fabric item
Deletes one item. A permanent delete only happens if hard-delete is set to true, and that needs the workspace Admin role.
Try: “Delete this old pipeline.”
Delete ·
core_delete-itemSearches the OneLake catalog
Looks for items across workspaces by name, description or workspace name, one page at a time.
Try: “Find items related to sales revenue.”
Network ·
core_search-catalogChecks a long-running operation
Checks where a long-running Fabric operation stands with a single read, and passes on the wait time Fabric suggests before asking again.
Try: “Is that operation finished?”
Network ·
core_get-operation-stateReads a finished operation's result
Returns the JSON result of a completed operation, up to 1 MiB.
Try: “Get the result of that operation.”
Network ·
core_get-operation-resultLists pipelines in a workspace
Shows the data pipelines in a workspace.
Try: “List the pipelines in this workspace.”
Network ·
datafactory_list-pipelinesShows one pipeline
Shows how one pipeline is set up.
Try: “Show how the nightly-load pipeline is set up.”
Network ·
datafactory_get-pipelineCreates a pipeline
Makes a data pipeline in the workspace you name.
Try: “Create a pipeline that copies sales data nightly.”
Write ·
datafactory_create-pipelineRuns a pipeline now
Triggers a run of an existing pipeline right now.
Try: “Run the nightly-load pipeline now.”
Write ·
datafactory_run-pipelineLists Dataflow Gen2 items
Shows the Dataflow Gen2 items in a workspace.
Try: “List the dataflows in this workspace.”
Network ·
datafactory_list-dataflowsCreates a Dataflow Gen2
Makes a Dataflow Gen2 item in a workspace.
Try: “Create a dataflow named Customer Clean-up.”
Write ·
datafactory_create-dataflowRuns a Power Query (M) query on a dataflow
Sends a Power Query (M) query to a dataflow and returns what it produces.
Try: “Run this M query on the customer dataflow.”
Write ·
datafactory_execute-queryLists workspaces visible to OneLake
Returns the workspaces you can see through OneLake.
Try: “Which workspaces can I open in OneLake?”
Network ·
onelake_list-workspacesLists items in a workspace
Shows the items in a workspace with a few key fields for each.
Try: “What items are in this workspace?”
Network ·
onelake_list-itemsLists items through the file endpoint
Returns the items in a workspace using the DFS (file system) endpoint.
Try: “List the items in this workspace via the file endpoint.”
Network ·
onelake_list-items-dfsLists files and folders
Returns the files and folders at a path in OneLake.
Try: “List the files in the Sales lakehouse.”
Network ·
onelake_list-filesDownloads a file
Copies a file from OneLake onto your computer.
Try: “Download report.csv from the lakehouse.”
Files ·
onelake_download-fileUploads a file
Sends a file from your computer into OneLake.
Try: “Upload this CSV to the Files folder.”
Write ·
onelake_upload-fileDeletes a file
Deletes one file in OneLake.
Try: “Delete the old export file.”
Delete ·
onelake_delete-fileCreates a folder
Makes a folder in OneLake.
Try: “Create a folder called archive.”
Write ·
onelake_create-directoryDeletes a folder
Deletes a folder in OneLake. A recursive option also deletes everything inside it.
Try: “Delete the temp folder and its contents.”
Delete ·
onelake_delete-directoryShows table API settings for an item
Shows how the table API is set up for one workspace item.
Try: “What is the table configuration of this lakehouse?”
Network ·
onelake_get-table-configLists table schemas
Lists the schemas (namespaces) that the table API exposes for an item.
Try: “What schemas does this lakehouse have?”
Network ·
onelake_list-table-namespacesShows one table schema
Shows the details of one namespace.
Try: “Show the dbo namespace.”
Network ·
onelake_get-table-namespaceLists tables in a schema
Lists the tables inside one namespace.
Try: “Which tables are in dbo?”
Network ·
onelake_list-tablesShows a table's definition
Shows the definition of one table.
Try: “Show the columns of the orders table.”
Network ·
onelake_get-tableLists data access roles on an item
Shows every data access role set on one item.
Try: “Which data access roles does this lakehouse have?”
Network ·
onelake_list-data-access-rolesShows one data access role
Returns a role's members, permissions and decision rules.
Try: “Show who is in the Analysts role.”
Network ·
onelake_get-data-access-roleCreates or edits a data access role
Adds or changes one data access role on an item, which changes who can read its data.
Try: “Give the Analysts role read access to the Sales folder.”
Write ·
onelake_create-or-update-data-access-roleDeletes a data access role
Removes one role from an item.
Try: “Delete the Interns role.”
Delete ·
onelake_delete-data-access-roleLists shortcuts in an item
Returns the shortcuts defined in an item. Shortcuts managed by a warehouse are hidden unless you ask.
Try: “List the shortcuts in this lakehouse.”
Network ·
onelake_list-shortcutsShows one shortcut
Shows how one shortcut is configured.
Try: “Show where this shortcut points.”
Network ·
onelake_get-shortcutCreates a shortcut to another OneLake location
Links data that lives in another OneLake location into the item as a shortcut.
Try: “Create a shortcut to the shared lakehouse.”
Write ·
onelake_create-shortcut-onelakeCreates a shortcut to Azure Data Lake Storage
Links an Azure Data Lake Storage Gen2 location into the item as a shortcut.
Try: “Create a shortcut to our ADLS container.”
Write ·
onelake_create-shortcut-adls-gen2Creates a shortcut to Amazon S3
Links an Amazon S3 location into the item as a shortcut.
Try: “Create a shortcut to the S3 bucket.”
Write ·
onelake_create-shortcut-amazon-s3Creates a shortcut to Azure Blob Storage
Links an Azure Blob Storage location into the item as a shortcut.
Try: “Create a shortcut to the blob container.”
Write ·
onelake_create-shortcut-azure-blobCreates a shortcut to Google Cloud Storage
Links a Google Cloud Storage location into the item as a shortcut.
Try: “Create a shortcut to the GCS bucket.”
Write ·
onelake_create-shortcut-gcsCreates a shortcut to S3-compatible storage
Adds a shortcut that points to storage that speaks the S3 protocol.
Try: “Create a shortcut to our MinIO bucket.”
Write ·
onelake_create-shortcut-s3-compatibleCreates a shortcut to Dataverse
Links a Dataverse environment into the item as a shortcut.
Try: “Create a shortcut to Dataverse.”
Write ·
onelake_create-shortcut-dataverseCreates a shortcut to OneDrive or SharePoint
Links OneDrive or SharePoint Online content into the item as a shortcut.
Try: “Create a shortcut to the team SharePoint site.”
Write ·
onelake_create-shortcut-onedrive-sharepointDeletes a shortcut
Removes a shortcut from an item. The data it points to is kept.
Try: “Delete the old S3 shortcut.”
Delete ·
onelake_delete-shortcutClears cached shortcut reads
Drops cached reads so the next read fetches from the destination again.
Try: “Reset the cache for this shortcut.”
Write ·
onelake_reset-shortcut-cacheShows OneLake workspace settings
Reads the diagnostic logging and immutability policy settings that apply to a workspace.
Try: “What are the OneLake settings for this workspace?”
Network ·
onelake_get-settingsChanges diagnostic logging
Changes a workspace's diagnostic logging status and the lakehouse that receives the logs.
Try: “Turn on diagnostic logging to the logs lakehouse.”
Write ·
onelake_modify-diagnosticsChanges the immutability policy
Sets the scope and the retention period in days of a workspace's OneLake immutability policy.
Try: “Set a 30-day immutability retention.”
Write ·
onelake_modify-immutability-policy
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
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
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-only | The 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 to | Microsoft Fabric and OneLake APIs |
| Sign-in and keys | Operational 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 |
|
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
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- CHANGELOG.md · github.com
- README.md · github.com