Skip to main content

​
Prerequisites

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

​
Configuration

Add to your Windsurf MCP config (~/.codeium/windsurf/mcp_config.json): 
{
  "mcpServers": {
    "nogic": {
      "command": "nogic",
      "args": ["mcp"],
      "env": {
        "NOGIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
Replace YOUR_API_KEY with your Nogic API key (starts with sk_).

​
Verify Connection

After adding the config:
  1. Restart Windsurf
  2. Open the AI chat
  3. Ask: “What Nogic tools do you have access to?”

​
Troubleshooting

“nogic: command not found” — Make sure Nogic is installed: uv tool install nogic or pip install nogic. Verify with nogic --version. Connection failed — Verify your API key is correct and that Windsurf was restarted after adding the config. 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