Install gx

gx connects to your agent via the Model Context Protocol. Pick the agent you use, follow the steps, then come back to your setup checklist.

Claude Code

1. Add the gx plugin marketplace and install the plugin:

/plugin marketplace add gxtools/plugin
/plugin install gx@gxtools

When prompted for gx_url, accept the default (https://gx.tools) or paste your local dev URL.

2. Or, configure the MCP server manually in ~/.claude/settings.json (no plugin):

{
  "mcpServers": {
    "gx": {
      "type": "http",
      "url": "https://gx.tools/mcp"
    }
  }
}

On first connect, your browser opens to authorize the connection.

1. In claude.ai, go to Settings → Connectors → Add custom MCP.

2. Paste:

Server URL: https://gx.tools/mcp
Authentication: OAuth (the prompt will open a browser window)
Scopes: read, write

claude.ai will redirect to gx for OAuth — sign in with the same account you used here.

1. Open Cursor Settings → MCP.

2. Add to your ~/.cursor/mcp.json (or the workspace equivalent):

{
  "mcpServers": {
    "gx": {
      "url": "https://gx.tools/mcp"
    }
  }
}

3. Reload Cursor and authorize when prompted.

From your agent, ask: "list my gx projects". You should see your projects listed.

Then try: "use gx-capture to record this" followed by something on your mind.