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. Day-to-day permissions and sandbox apply to individual use; managed locks and headless modes are under Enterprise.

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 21, 2026