# Gitpod MCP for AI Agents AI Agent Connect > Gitpod MCP lets your AI agent manage cloud development environments. You can create, start, and stop workspaces, manage organization members, and handle environment variables without leaving your chat or editor. It connects your Gitpod account to your AI client so you can orchestrate your dev lifecycle through natural language. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_aH3yuGAtuYXWmHSnjEgDltq9tzMJdJjekxoiZf2G/ai-agent-connect - **Tags:** cloud-ide, development-environments, automation, workspace-management, remote-development, ci-cd ## Description This Connector lets you orchestrate your cloud development lifecycle through natural language. Managing cloud environments usually involves jumping between a terminal, a web dashboard, and several configuration files. It's a lot of context switching that pulls you out of your flow. This connection changes that by letting your AI client handle the heavy lifting. Instead of manually hunting for a repository URL or digging through the Gitpod dashboard to find an organization ID, you just tell your agent what you need. You can have it spin up a workspace for a specific PR, update environment variables across a team, or audit who has access to your organization. It's about moving the management part of development into the same window where you're actually writing code. When you find this in the Vinkius catalog, you're getting a way to turn your AI into a devops assistant that knows your infrastructure. You get to stay in the flow of coding while the agent handles the plumbing of your cloud IDE. This means you can focus on the logic of your application rather than the logistics of your environment. You can manage everything from organization settings to workspace hibernation with just a few words. ## Tools ### get_organization This tool fetches the details of a specific Gitpod organization. Use it to check membership and basic settings. ### list_audit_logs This tool pulls the audit logs for an organization to monitor activity. It is essential for security compliance and tracking. ### list_configurations This tool shows all repository configurations within a specific organization. Use it to see all your project launch rules. ### create_environment_variable This tool adds a new environment variable to an existing repository configuration. It ensures your team has the correct keys and settings for every project. ### delete_environment_variable This tool deletes an existing environment variable from a configuration. Use it to remove outdated keys or secrets. ### remove_organization_member This tool kicks a member out of a Gitpod organization. It is useful for managing team access and security. ### delete_organization This tool permanently deletes a Gitpod organization. Use it to remove entire teams or projects from your account. ### delete_workspace This tool deletes an existing Gitpod workspace. Use it to free up resources and keep your environment list clean. ### get_configuration This tool retrieves the current details for a specific repository configuration. It helps you verify your current project settings. ### get_workspace This tool gets the current status and details of a specific workspace. It helps you check if a workspace is running or hibernated. ### join_organization This tool joins an organization using a provided invitation ID. It helps new team members get into the right workspace group. ### list_environment_variables This tool lists all environment variables for a repository configuration. Use it to check what variables are currently set. ### list_organization_members This tool shows the list of members in a Gitpod organization. It helps you manage who has access to your resources. ### list_organizations This tool lists all organizations associated with your account. Use it to see your entire team structure at a glance. ### list_workspace_sessions This tool shows the start and stop events for workspaces in an organization. It helps you monitor how your team uses their resources. ### list_workspaces This tool lists all active and inactive workspaces in an organization. It helps you keep track of all your current dev environments. ### start_workspace This tool starts an existing Gitpod workspace that isn't currently running. Use it to wake up an environment you used earlier. ### stop_workspace This tool stops a running workspace to put it into hibernation. Use it to save resources and lower your costs. ### update_configuration This tool modifies the settings of an existing repository configuration. Use it to update your project launch rules on the fly. ### update_organization_member This tool changes the role of a member within a Gitpod organization. Use it to promote or demote users within your team. ### update_organization_settings This tool updates the general settings for a Gitpod organization. Use it to change organization-wide rules and defaults. ### create_and_start_workspace This tool creates a new Gitpod workspace and starts it immediately for a specific repository. It saves you from manual setup and lets you jump into coding faster. ### create_configuration This tool sets up a new repository configuration within your Gitpod account. It helps you define how your projects launch and behave. ### create_organization This tool creates a new Gitpod organization for team management. It helps group your repositories and members together. ### delete_configuration This tool removes a specific repository configuration from your account. Use it to clean up old or unused project settings. ### get_organization_settings This tool pulls the current settings for a Gitpod organization. It lets you see how your team's environment is configured. ## Prompt Examples **Prompt:** ``` Can you spin up a workspace for the project at https://github.com/example/repo? ``` **Response:** ``` I'm starting that for you now. You'll get a notification with the link as soon as the environment is ready. ``` **Prompt:** ``` Who's currently in our Engineering organization? ``` **Response:** ``` Here are the current members of the Engineering organization: | Name | Role | | :--- | :--- | | Alice | Admin | | Bob | Developer | | Charlie | Developer | Would you like to add anyone else? ``` **Prompt:** ``` Stop all the workspaces in the 'Marketing' organization to save costs. ``` **Response:** ``` I've identified 4 active workspaces in the Marketing organization. I am stopping them now to put them into hibernation. ``` ## Capabilities ### Create and start workspaces This tool creates a new Gitpod workspace and starts it immediately for a specific repository. It saves you from manual setup and lets you jump into coding faster. ### Manage organization members This tool lets you add or remove people from your Gitpod organization. Use it to keep your team's access levels organized and secure. ### Update environment variables This tool adds or modifies environment variables for your repository configurations. It ensures your team has the correct keys and settings for every project. ### Audit workspace activity This tool pulls audit logs to show how your team is using their dev environments. It's essential for security compliance and monitoring. ### Configure repository settings This tool manages the specific rules for how your projects launch. Use it to standardize your dev setups across the entire organization. ## Use Cases ### Rapid PR Review Setup The Gitpod MCP handles the rapid setup of PR environments. A dev needs to check a bug in a new branch and asks the agent to create a workspace for the repo. The agent gives them a link to a fresh environment in seconds. ### Bulk Env Var Updates The Gitpod MCP manages bulk updates to configuration keys. A DevOps engineer needs to update a production API key across 10 configs. They ask the agent to use `create_environment_variable` for each repository configuration. ### Onboarding New Hires The Gitpod MCP simplifies team onboarding. A manager wants to add 5 new people to a team. They ask the agent to use `join_organization` and `update_organization_member` to get everyone set up. ### Cost Auditing The Gitpod MCP provides visibility into infrastructure spend. A lead notices high costs. They ask the agent to use `list_workspace_sessions` to see which environments are staying active too long. ## Benefits - Stop manual environment setup by using `create_and_start_workspace` to launch dev environments instantly. - Keep your team's access tight by managing organization members and roles with `remove_organization_member` and `update_organization_member`. - Standardize your dev setups by using `create_configuration` and `create_environment_variable` to sync across the team. - Save money and resources by using `stop_workspace` to hibernate environments when you're done. - Get full visibility into team activity by pulling audit logs with `list_audit_logs` for security compliance. - Simplify your workflow by using `list_organizations` and `list_workspaces` to see everything in one chat window. ## How It Works The bottom line is you stop manual dashboard clicking and start using natural language to manage your cloud dev lifecycle. 1. Connect your Gitpod Personal Access Token to the Connector. 2. Tell your agent to perform a task, like starting a workspace or listing organizations. 3. The agent executes the command and gives you the direct link or status update. ## Frequently Asked Questions **Can the Gitpod MCP help me set up dev environments for my team?** Yes. It lets your AI agent create and configure workspaces for any repository, making it easy to get everyone started on the same setup without manual configuration. **How does the Gitpod MCP handle organization permissions?** It gives your agent the ability to list members, join organizations, and update roles. You can manage your team's access levels directly through your chat interface. **Can I use the Gitpod MCP to monitor workspace usage?** Yes, it can pull audit logs and list workspace sessions. This helps you see how your team is using their environments and helps with cost management. **Will the Gitpod MCP manage my environment variables?** It can create, list, and delete environment variables for your repository configurations. This ensures your team has the correct keys and settings for every project. **Is the Gitpod MCP good for DevOps automation?** It's built for it. You can automate the entire lifecycle of your cloud IDEs, from initial creation to final deletion, using natural language commands. **Can I use the Gitpod MCP to list all my organizations?** Yes, the Connector can pull a full list of all organizations associated with your account. This helps you see your entire team structure at a glance. **Can I create a workspace from a repo URL?** Yes! Use the `create_and_start_workspace` tool with the repository URL. Your agent will provision and start a cloud environment for that specific context immediately. **How do I see who is in my organization?** Simply ask the agent to run the `list_organization_members` action with your Organization ID. It will return a list of all users and their roles within that organization. **Can I manage environment variables for my development setups?** Yes. You can use `create_environment_variable` to set new secrets or configs, and `list_environment_variables` to review existing ones for your workspaces.