Skip to main content
The Settings dialog provides a streamlined, tabbed interface for configuring Vibe Kanban.

​
Accessing Settings

Workspaces navbar showing the Settings gear icon with tooltip
  • Click the Settings icon () in the Workspaces navbar
  • Press Cmd/Ctrl + K and select Settings

​
Settings Tabs

Settings dialog showing the tabbed interface with General, Projects, Repositories, Organization Settings, Agents, and MCP Servers tabs
The settings dialog is organised into the following tabs:
TabDescription
GeneralAppearance, default agent, editor, git, and notifications
ProjectsProject-specific settings
RepositoriesRepository scripts (dev server, setup, cleanup)
Organization SettingsOrganisation members, invitations, and settings
Remote ProjectsCloud-synced projects across organisations
AgentsAgent profiles and variants
MCP ServersModel Context Protocol server configuration

​
General

Configure appearance, default agent, editor, git preferences, notifications, and tags.

General Settings

Complete guide to general settings including appearance, editor configuration, and more

​
Projects & Repositories

Configure project-specific settings and repository scripts including dev server, setup, and cleanup commands.

Projects & Repositories

Configure project settings and repository scripts

​
Organization Settings

Manage your Cloud organisations, invite team members, and configure organisation-level settings.

Organisation Settings

Manage members, invitations, and organisation settings

​
Remote Projects

View and manage all your Cloud-synced projects across organisations. Create, edit, and delete projects from a centralised interface.

Remote Projects

Manage Cloud projects across all your organisations

​
Agents

Agents tab showing agent list, configuration variants, and settings options
Define and customise agent variants using a form-based interface. The Agents tab uses a finder-style two-column layout:
  • Left column (Agents) - Available coding agents (Claude Code, Codex, Opencode, Cursor Agent, etc.)
  • Right column (Configurations) - Different variants for the selected agent (Default, Opus, Approvals, Plan, etc.)

Agent Profiles & Variants

Detailed guide with examples for configuring agent variants

​
MCP Servers

MCP Servers tab showing agent selection, JSON configuration, and popular servers
Configure Model Context Protocol servers to extend coding agent capabilities with custom tools and resources.
  • Agent - Choose which agent to configure MCP servers for (e.g., Claude Code)
  • Server Configuration (JSON) - Edit the MCP server configuration directly in JSON format
  • Popular servers - Click a card to insert a pre-configured MCP server into the JSON

Connecting MCP Servers

Configure MCP servers within Vibe Kanban for your coding agents
  • Workspaces - The Workspaces UI where settings are accessed