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

# get_drive

Get a drive by name or drive ID, for example to check its size, region, or whether it exists. Returns a 404 error when the drive doesn't exist. This tool never creates a drive. Use [`get_or_create_drive`](/docs/agent-resources/vercel-mcp/tools/drives/get_or_create_drive) to provision one.

## Parameters

| Parameter   | Type   | Required | Description                                                                                                       |
| ----------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------- |
| `nameOrId`  | string | Yes      | The drive name or ID.                                                                                             |
| `projectId` | string | No       | The project ID or name associated with the drive. Required unless using a Vercel OIDC token scoped to a project.  |
| `teamId`    | string | No       | Team ID.                                                                                                          |
| `slug`      | string | No       | Team slug.                                                                                                        |

## 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.
