Introducing Filesystem Mounts for Mastra Workspaces

You can now use multiple filesystems from a single Mastra workspace with mounts. Read from restricted storage environments and write to the filesystems your team already use. Mastra supports a number of remote filesystems letting you mix-and-match to suit your needs.

By configuring multiple filesystems, your agents, tools, and workflows can read from multiple sources, combine the data, and write to a destination through the same file interface.

Before mounts, a Mastra workspace attached one filesystem at a time. Reading from one provider and writing to another meant hand-rolling the routing, or calling underlying SDKs directly. Now, all filesystems are available through the mountPath, making it easier to read and write across multiple filesystems.

Under the hood, mounts builds a CompositeFilesystem that routes each read or write to the correct provider. With a sandbox configured, Mastra also mounts each provider with FUSE (Filesystem in Userspace).