Settings

View as Markdown
Create API keyMeet grok-4.5

Grok Build offers a variety of configurations to suit your needs, many of which are made directly available in the TUI under /settings.

Settings are persisted under ~/.grok/config.toml (on Windows, %USERPROFILE%\.grok\config.toml). To configure the default home directory, you can set $GROK_HOME.

For MCP servers, see MCP Servers. For marketplaces, skills, and plugins, see Skills, Plugins, and Marketplaces; for hooks, see Hooks.

Scopes

ScopePathUse for
EnvironmentGROK_* (and related) variablesSession / CI overrides
User~/.grok/config.toml (or $GROK_HOME/config.toml)Personal defaults
Project.grok/config.toml in the repoRepo-shared MCP, plugins, and permission rules
Managed~/.grok/managed_config.toml, /etc/grok/managed_config.tomlEnterprise-served defaults
Requirements~/.grok/requirements.toml, /etc/grok/requirements.tomlPolicy pins

Project configs are limited to MCP servers, plugins, and permission rules, not full user configs. For scope merge order and managed deployments, see Enterprise Deployments. Permission rules and sandboxing are documented there too — they apply to individual use as much as to fleets.

Verification

To confirm which configs are picked up by Grok Build, run the following command:

Bash

grok inspect

Example config.toml

Copy into $GROK_HOME/config.toml, or ~/.grok/config.toml when GROK_HOME is unset. Prefer /settings for UI, notifications, and other in-app options.

TOML

[models]
default = "grok-build"                       # recommended for coding / agent sessions
web_search = "grok-4.5"                      # model used by client-side web_search tool

[model."grok-4.5"]
model = "grok-4.5"                           # id sent to the API
base_url = "https://api.x.ai/v1"             # provider endpoint
name = "Grok 4.5"                            # shown in model picker
description = "Grok 4.5 from xAI"
env_key = "XAI_API_KEY"                      # env var holding the API key
api_backend = "responses"                    # chat_completions | responses | messages
temperature = 0.7
top_p = 0.95
max_completion_tokens = 8192
context_window = 1000000
extra_headers = { "x-api-key" = "xai-..." }
supports_backend_search = true               # if the endpoint supports Grok-hosted server-side search tools

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
enabled = true
startup_timeout_sec = 30
tool_timeout_sec = 6000

[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
headers = { "Authorization" = "Bearer ${LINEAR_API_KEY}", "x-mcp-session-id" = "{{session_id}}" }

TOML Values

For the full list of config.toml keys, see TOML Values.

Environment variables

For the full list of environment variables, see Environment variables.

Last updated: July 6, 2026