• ACCESS
  • CONFIG
  • AUDIT
  • HUMAN

How to administer Gitpod organizations with your AI

Connect Gitpod to your AI agent to handle administrative tasks. You can manage users and settings without clicking through the dashboard.

Ask AI about this page

Short answer

Can I manage my Gitpod organization using an AI agent?

Yes. Your agent can pull organization details, change member permissions, and check audit logs. You'll see how these capabilities work below.

Administrative outcomes

Where your changes land.

Your agent handles these four specific areas of organization management.

ACCESS

Member control

The AI manages who is in your organization. You can add or remove people and change their roles via chat.

CONFIG

Settings management

Your agent updates organization-wide configurations. This lets you adjust how Gitpod behaves for everyone in the group.

AUDIT

Activity logs

The AI pulls audit logs so you can see recent changes. You get a clear view of what happened in the organization.

HUMAN

Manual decisions

You decide which users get access. The AI executes the specific commands you give it, but you keep the final say.

The workflow

What your AI does when <the thing arrives>.

The agent acts as a direct interface for the Gitpod API.

  1. Locate organization

    The agent identifies the specific organization you want to manage.

    list_organizationsget_organization

  2. Update membership

    The agent modifies user roles or removes people from the group.

    list_organization_membersupdate_organization_memberremove_organization_member

  3. Change settings

    The agent applies new configuration rules to the organization.

    update_organization_settings

  4. Fetch logs

    The agent retrieves audit logs to show recent activity.

    list_audit_logs

Try it

Copy these to start.

Use these prompts to trigger the Gitpod Connector.

Starting points

These are starting points. Replace the organization names or email addresses with your actual Gitpod data.

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

  • List all members in my 'core-devs' organization.

  • Remove 'alex@example.com' from the 'frontend-team' organization.

  • Show me the audit logs for the 'production-org'.

  • Update the settings for the 'sandbox-environment' organization.

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

Start here

Connect Gitpod once, then ask.

Connect your account in one click. Your login stays encrypted on our side, and you can start using the tools immediately.

Connect Gitpod to your AI

FAQ

How this task behaves

  • 01

    Can the AI create a new organization?

    No. The agent can only manage existing organizations.

  • 02

    Can the AI delete an organization?

    No. There is no tool available to delete an organization.

  • 03

    Can I use the AI to add a new member?

    Yes. The agent can use the join tool to add people to your organization.

  • 04

    Does the AI have access to my Gitpod password?

    No. The agent only uses the specific tools provided in the manifest.

  • 05

    Can the AI change my personal user settings?

    No. The tools are limited to organization-level management.

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

Connect Gitpod to Claude, Cursor, ChatGPT & more