# Vercel Manager

> Manage Vercel projects and deployments via the Vercel REST API. Use when listing, creating, or managing Vercel projects, deployments, or domains. Requires VERCEL_TOKEN in .env file.

- Skill: `namick/vercel-manager` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add namick/vercel-manager`
- Raw SKILL.md: https://api.skillmd.com/api/skills/namick/vercel-manager/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: namick (https://skillmd.com/u/namick)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/namick/vercel-manager

---


# Vercel Manager

Manage Vercel projects and deployments using the Vercel REST API with single-file Python scripts.

## Setup

Create a `.env` file at your project root with your Vercel token:

```
VERCEL_TOKEN=your_token_here
```

Get a token from [Vercel Dashboard > Account Settings > Tokens](https://vercel.com/account/tokens).

## Available Operations

### List Projects

List all Vercel projects for your account or team:

```bash
./scripts/list_projects.py
```

Output format:
```json
{
  "projects": [
    {
      "id": "prj_abc123",
      "name": "my-project",
      "framework": "nextjs",
      "createdAt": 1705312200000,
      "updatedAt": 1705312200000
    }
  ]
}
```

### Create Project

Create a new Vercel project with optional GitHub integration, environment variables, framework, and build command overrides:

```bash
echo '<json>' | ./scripts/create_project.py
```

**Input JSON format:**
```json
{
  "name": "my-project",
  "framework": "nextjs",
  "buildCommand": "npx convex deploy --cmd 'npm run build'",
  "installCommand": "npm install",
  "outputDirectory": ".next",
  "gitRepository": {
    "repo": "owner/repo-name",
    "type": "github"
  },
  "envVars": [
    {
      "key": "DATABASE_URL",
      "value": "postgresql://...",
      "type": "encrypted",
      "target": ["production", "preview"]
    }
  ]
}
```

**Fields:**
- `name` (required): Project name
- `framework` (optional): `nextjs`, `vite`, `remix`, `nuxtjs`, `gatsby`, `astro`, etc.
- `buildCommand` (optional): Override the build command
- `installCommand` (optional): Override the install command
- `outputDirectory` (optional): Override the output directory
- `gitRepository` (optional): Link to a GitHub/GitLab/Bitbucket repo
  - `repo`: `owner/repo-name` format
  - `type`: `github`, `gitlab`, or `bitbucket`
- `envVars` (optional): Array of environment variables
  - `key`: Variable name
  - `value`: Variable value
  - `type`: `encrypted` or `plain`
  - `target`: Array of `production`, `preview`, `development`

**Examples:**

Simple project:
```bash
echo '{"name": "my-app"}' | ./scripts/create_project.py
```

Next.js with Convex:
```bash
echo '{
  "name": "my-convex-app",
  "framework": "nextjs",
  "buildCommand": "npx convex deploy --cmd '''npm run build'''",
  "gitRepository": {
    "repo": "myorg/my-convex-app",
    "type": "github"
  },
  "envVars": [
    {"key": "CONVEX_DEPLOY_KEY", "value": "prod:xxx", "type": "encrypted", "target": ["production"]}
  ]
}' | ./scripts/create_project.py
```

### Deploy to Production

Deploy a project to Vercel production:

```bash
./scripts/deploy.py <project_directory>
```

**Arguments:**
- `project_directory`: Path to the project to deploy (required)

**Example:**
```bash
./scripts/deploy.py ./my-app
```

Output format:
```json
{
  "status": "success",
  "projectDirectory": "/path/to/my-app",
  "deploymentUrl": "https://my-app.vercel.app"
}
```

This script:
- Reads VERCEL_TOKEN from the .env file
- Runs `bunx vercel deploy --prod --yes` with the token
- Returns the deployment URL on success

## Error Handling

**Missing .env file**:
```
Error: .env file not found in current directory or parent directories
```
Create a `.env` file at the project root with your VERCEL_TOKEN.

**Missing token in .env**:
```
Error: VERCEL_TOKEN not found in .env file
```
Add `VERCEL_TOKEN=your_token` to your .env file.

**Invalid token**:
```
Error: Unauthorized - verify your token is correct
```
Get a new token from the Vercel Dashboard under Account Settings > Tokens.

**Project already exists**:
```
Error: Project with this name already exists
```
Choose a different project name.