• READY
  • ACTIVE
  • CLEAN
  • HUMAN

How to manage Gitpod workspaces with your AI

Connect your AI to Gitpod to run your dev environments through natural language. Once connected, your agent handles the heavy lifting of environment lifecycle management.

Ask AI about this page

Short answer

Can I control Gitpod with my AI?

Yes. You can tell your AI to spin up new environments, check what's running, or kill old workspaces. This gives you full control over your cloud dev lifecycle without leaving your chat interface.

Where every action lands.

Workspace management outcomes

Your AI translates your intent into direct Gitpod actions.

READY

Instant dev environments

The AI uses Gitpod to spin up a fresh workspace based on your request. You get a ready-to-code environment immediately.

ACTIVE

Real-time status checks

Your agent pulls current workspace data to show you what is running or idling. You stay updated on your cloud resources.

CLEAN

Automated resource cleanup

The AI deletes workspaces you no longer need. This keeps your Gitpod account tidy and prevents wasted resources.

HUMAN

Manual code edits

The AI manages the environment, but you still handle the actual coding. You retain full control over the files and logic inside the workspace.

The workflow

What your AI does when you request workspace changes.

The AI acts as a bridge between your chat and the Gitpod API.

  1. Provisioning

    When you need to start a new task, the AI sets up the environment for you.

    create_and_start_workspace

  2. Monitoring

    Your agent checks the status of existing environments to see what is active or needs attention.

    list_workspacesget_workspace

  3. Resuming work

    If an environment was stopped, the AI can bring it back online.

    start_workspacestop_workspace

  4. Cleanup

    The AI removes environments once you are finished with a project.

    delete_workspace

Try it

Copy these to start.

Use these prompts to trigger Gitpod actions immediately.

Starting points

Swap out the repository names or workspace IDs with your actual Gitpod details.

Gitpod Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_aH3yuGAtuYXWmHSnjEgDltq9tzMJdJjekxoiZf2G/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Gitpod capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "gitpod-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_aH3yuGAtuYXWmHSnjEgDltq9tzMJdJjekxoiZf2G/mcp"
    }
  }
}
Copy into chat04

  • Create and start a new Gitpod workspace for the repo 'frontend-app'.

  • List all my current Gitpod workspaces so I can see what is running.

  • Stop the workspace with ID 'dev-env-123' to save resources.

  • Delete the workspace for the 'legacy-service' repo.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Gitpod once, then ask.

Follow the link to authorize the connection. Your credentials stay encrypted, and you can start managing environments in your favorite AI client right away.

Connect Gitpod to your AI

FAQ

How the Gitpod Connector behaves

  • 01

    Can my AI write code inside the workspace?

    No. The AI manages the workspace lifecycle, such as creating and deleting it, but it does not edit the files within the environment.

  • 02

    Will the AI delete my workspaces without asking?

    No. The AI only executes a deletion when you explicitly instruct it to do so in your chat.

  • 03

    Can I see a list of all my workspaces?

    Yes, you can ask your AI to list your active and inactive workspaces.

  • 04

    Can the AI change my Gitpod subscription settings?

    No. The AI only has tools to manage workspaces, not account or billing settings.

  • 05

    Can I start a stopped workspace?

    Yes, you can tell your AI to start a specific workspace that was previously stopped.

  • More questions about Gitpod? The Connector page answers them. See everything the Gitpod Connector can do

Connect Gitpod to Claude, Cursor, ChatGPT & more