Skip to main content

​
Prerequisites

  • Nogic CLI installed (uv tool install nogic or pip install nogic)
  • A project initialized with nogic init

​
VS Code

Add to your VS Code MCP config (~/Library/Application Support/Code/User/mcp.json on macOS): 
{
  "servers": {
    "nogic": {
      "command": "nogic",
      "args": ["mcp"],
      "env": {
        "NOGIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
VS Code uses "servers" as the config key, not "mcpServers".

​
Antigravity

Add to your Antigravity MCP config (~/Library/Application Support/antigravity/User/mcp.json on macOS): 
{
  "servers": {
    "nogic": {
      "command": "nogic",
      "args": ["mcp"],
      "env": {
        "NOGIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
Antigravity uses "servers" as the config key, not "mcpServers".

​
Claude Desktop

Add to your Claude Desktop config:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "nogic": {
      "command": "nogic",
      "args": ["mcp"],
      "env": {
        "NOGIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

​
Codex CLI

Add to ~/.codex/mcp.json: 
{
  "mcpServers": {
    "nogic": {
      "command": "nogic",
      "args": ["mcp"],
      "env": {
        "NOGIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

​
Gemini CLI

Add to ~/.gemini/mcp.json: 
{
  "mcpServers": {
    "nogic": {
      "command": "nogic",
      "args": ["mcp"],
      "env": {
        "NOGIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

​
Generic MCP Client

For any MCP client that supports stdio transport, use this config: 
{
  "nogic": {
    "command": "nogic",
    "args": ["mcp"],
    "env": {
      "NOGIC_API_KEY": "YOUR_API_KEY"
    }
  }
}
The wrapper key ("mcpServers" or "servers") depends on your client. Check your editor’s MCP documentation.

​
Troubleshooting

“nogic: command not found” — Make sure Nogic is installed: uv tool install nogic or pip install nogic. Verify with nogic --version. Connection timeout — The first connection may take a few seconds while the backend initializes. Restart your editor and try again. Tools not working — Make sure .nogic/config.json exists in your project root. Run nogic status to verify.

​
Next Steps

MCP Tools Reference

See all available MCP tools