Azure Files
Browse files and directories stored in Azure Files shares, read required files, or import them into file storage. If needed, you can also create new directories in an Azure Files share or upload files created during work to Azure Files.
Key Features
- List file shares in an Azure Storage account
- Browse directories and files in a share
- View file or directory metadata
- Read text file content
- Download PDF, Office documents, and binary files
- Search files by part of the file name or path
- Create a new directory under an existing directory
- Upload files from file storage to an Azure Files share
Basic Information
Authentication Method
Microsoft OAuth authentication is used.
Usage Scope
This MCP accesses Azure Files cloud storage. It is not used to browse or read the user’s local file system.
Supported MCP Tools
list_shares
Lists Azure Files shares accessible from the configured Azure Storage account. Use this first when the user has not specified a share name.
list_directory
Lists files and subdirectories under the specified share and directory path. Results may include name, path, type, and size information.
get_file_metadata
Retrieves metadata for a file or directory. Use this to check size and content type before reading or downloading file content.
read_file
Reads text file content stored in Azure Files directly in the chat response. Use download_file for binary files or large files.
download_file
Downloads a file from Azure Files into file storage and returns an aip-temp:// or aip-drive:// URI. Use this for PDF, Office documents, images, and binary files that are difficult to display directly in chat.
search_files
Searches Azure Files by strings included in file names or paths. Full-text content search is not supported. If the search range is too broad, narrow the path or search term and run it again.
create_directory
Creates a new directory under an existing parent directory in the specified share. It creates only one directory level at a time. If the parent directory does not exist, check where the directory should be created first. If the target directory already exists, it is treated as the existing directory instead of being created again.
upload_file
Uploads an AIP file URI created or imported from chat, a Skill, or another MCP tool as a new file in an existing directory of an Azure Files share. If a file with the same name already exists, the upload fails. Existing files are not overwritten and file names are not changed automatically.
Usage Examples
- “Find the 2026 sales report in the
reportsshare in Azure Files” - “Show me what files are in the
/monthlyfolder of thefinanceshare” - “Read the contents of
summary.txtin Azure Files” - “Import the contract PDF as a file and summarize it”
- “Create a
2026-08folder under/monthlyin thefinanceshare” - “Upload the report I just created to the
reports/2026folder in Azure Files”
Notes
- A Microsoft account with access to the Azure Storage account and Azure Files share is required.
read_fileis suitable for text files. For PDF, Office documents, images, and large files, download the file first and process it with another tool or Skill.search_filessearches by file name and path, not by file body content.create_directorydoes not create multiple folder levels at once. Create parent directories first if needed.upload_filesaves a new file into an existing Azure Files directory. It does not create the target directory automatically and does not overwrite existing files.upload_filecurrently supports SMB Azure Files shares only. It cannot upload to NFS shares.