---
title: get_or_create_drive
product: vercel
url: /docs/agent-resources/vercel-mcp/tools/drives/get_or_create_drive
canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/drives/get_or_create_drive"
last_updated: 2018-10-20
type: reference
prerequisites:
  - /docs/agent-resources/vercel-mcp/tools/drives
  - /docs/agent-resources/vercel-mcp/tools
related:
  - /docs/regions
summary: Use get_or_create_drive with Vercel MCP.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
search_with_vercel_cli: npx vercel@latest docs search "<query>"
---

# get_or_create_drive

Get an existing drive by name in a project, or create it when it doesn't exist. `maxSizeBytes` and `region` apply only when the call creates the drive. They don't resize or move an existing one. This tool doesn't start a sandbox or attach the drive to a session.

## Parameters

| Parameter     | Type   | Required | Description                                                                                        |
| ------------- | ------ | -------- | -------------------------------------------------------------------------------------------------- |
| `name`        | string | Yes      | Name for the drive. Must be unique per project and URL-safe (alphanumeric, hyphens, underscores).  |
| `teamId`      | string | No       | Team ID.                                                                                           |
| `slug`        | string | No       | Team slug.                                                                                         |
| `requestBody` | object | No       | Request body for this tool.                                                                        |

### Request body fields

| Field          | Type    | Required | Description                                                                                                                                                                                |
| -------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `projectId`    | string  | No       | The project ID or name to associate the drive with. Required unless using a Vercel OIDC token scoped to a project.                                                                         |
| `maxSizeBytes` | integer | No       | Maximum drive size in bytes. Must be a multiple of 4096. Defaults to 1 TiB (1 GiB on Hobby). The maximum is 16 TiB. Request a higher quota at [vercel.com/help](https://vercel.com/help).  |
| `region`       | string  | No       | [Region](/docs/regions) where the drive is stored. Defaults to `iad1`.                                                                                                                     |

## Search the docs from your terminal

Search the Vercel docs and read pages as Markdown with the Vercel CLI. No login required.

```bash
# Find docs pages by keyword
npx vercel@latest docs search "environment variables"
npx vercel@latest docs search "function timeout"

# Print a docs page as Markdown, by path or URL
npx vercel@latest docs inspect <page>
```

---

[View full sitemap](/docs/sitemap)


If you encounter incorrect information, can’t find what you need, need a capability Vercel doesn’t currently offer, or have any other feedback to report, please do it by following the instructions at https://vercel.com/feedback.md.
