email-notifications

```bash

# Install

npm install -g snow-flow

# Start the TUI

snow-flow

# Authenticate (in the TUI)

/auth

```

That's it. Snow-Flow auto-initializes on first run and guides you through authentication with ServiceNow and your preferred LLM provider.

---

Snow-Flow is an open-source AI development platform for ServiceNow. It uses the Model Context Protocol (MCP) to give AI assistants direct access to your ServiceNow instance through 400+ specialized tools.

Talk to your ServiceNow instance in plain English:

```

> Create a dashboard widget showing P1 incidents with SLA countdown timers

> Build a business rule to auto-assign incidents based on category

> Show me all incidents assigned to my team from the last week

> Create a knowledge article explaining the password reset process

```

Snow-Flow handles everything: Update Set creation, ES5 validation, widget coherence checks, and deployment.

---

vs ServiceNow Build Agent

| Feature | Snow-Flow | ServiceNow Build Agent |

|---------|-----------|------------------------|

| Cost | Free (open source) | $150K-$4.5M implementation |

| AI Model | 75+ providers - Claude, GPT, Gemini, DeepSeek, Ollama | NowLLM only |

| Development | Any IDE - VS Code, Cursor, terminal, JetBrains | Browser-based Studio |

| Integrations | Jira, Azure DevOps, Confluence, GitHub | ServiceNow only |

| Source Code | 100% open source | Proprietary |

| Self-hosted | Yes | No |

| Architecture | Multi-agent orchestration | Single agent |

Key Features

• 379+ MCP Tools - Complete ServiceNow coverage across 15 categories
• Any LLM Provider - Claude, GPT, Gemini, DeepSeek, Llama, or free with Ollama
• Built-in TUI - Interactive terminal interface with keyboard shortcuts
• ES5 Validation - Catches Rhino engine errors before deployment
• Update Set Management - Automatic change tracking
• Widget Coherence - Validates HTML/Client/Server communication
• Local Development - Pull artifacts to local files, edit with your IDE, push back
• Multi-IDE Support - Claude Desktop, Cursor, Windsurf, Continue.dev

---

```

┌─────────────────────────────────────────────────────────────────┐

│ Snow-Flow TUI │

│ ───────────────────────────────────────────────────────────── │

│ │

│ You: Create an incident dashboard widget with priority charts │

│ │

│ ┌─ Snow-Flow ─────────────────────────────────────────────┐ │

│ │ 1. Creating Update Set: "Feature: Incident Dashboard" │ │

│ │ 2. Building widget template (HTML)... │ │

│ │ 3. Writing server script (ES5 validated)... │ │

│ │ 4. Writing client controller... │ │

│ │ 5. Validating widget coherence... │ │

│ │ 6. Deploying to dev12345.service-now.com... │ │

│ │ ✓ Widget deployed: incident_dashboard │ │

│ │ │ │

│ │ Preview: https://dev12345.service-now.com/sp?id=... │ │

│ └─────────────────────────────────────────────────────────┘ │

│ │

│ You: _ │

└─────────────────────────────────────────────────────────────────┘

```

---

Snow-Flow provides 379 tools across 15 categories:

| Category | Tools | Read | Write | Description |

|----------|-------|------|-------|-------------|

| Platform Development | 78 | 25 | 53 | Script includes, client scripts, UI development |

| Automation | 57 | 24 | 33 | Script execution, scheduled jobs, events |

| Advanced AI/ML | 52 | 44 | 8 | Classification, anomaly detection, predictions |

| ITSM | 45 | 17 | 28 | Incident, change, problem management |

| Integration | 33 | 13 | 20 | REST messages, transform maps, import sets |

| Core Operations | 30 | 14 | 16 | CRUD operations, queries, bulk operations |

| UI Frameworks | 19 | 4 | 15 | Portal widgets, UI pages, forms |

| Security | 18 | 9 | 9 | ACLs, policies, compliance |

| CMDB | 14 | 10 | 4 | CI management, relationships, discovery |

| Reporting | 10 | 3 | 7 | Reports, dashboards, KPIs |

| UI Builder | 9 | 2 | 7 | Now Experience components |

| Asset Management | 8 | 1 | 7 | Asset lifecycle, contracts |

| Performance Analytics | 3 | 2 | 1 | PA indicators, breakdowns |

| ML Analytics | 2 | 2 | 0 | Native ML features |

| Workspace | 1 | 0 | 1 | Agent Workspace config |

Browse all tools: [snow-flow.dev/en/mcp-reference](https://snow-flow.dev/en/mcp-reference)

---

1. Install Snow-Flow

```bash

npm install -g snow-flow

```

2. Start the TUI

```bash

snow-flow

```

On first run, Snow-Flow automatically creates:

• .mcp.json - MCP server configuration
• CLAUDE.md / AGENTS.md - AI instructions

3. Authenticate

In the TUI, type /auth to authenticate:

1. LLM Provider - Claude, GPT, Gemini, Ollama, etc.
2. ServiceNow - OAuth 2.0 (requires OAuth app in ServiceNow)

Detailed OAuth setup: [snow-flow.dev/en/oauth-setup](https://snow-flow.dev/en/oauth-setup)

---

Create an OAuth application in your ServiceNow instance:

1. Navigate to System OAuth → Application Registry
2. Click New → Create an OAuth API endpoint for external clients
3. Configure:

- Name: Snow-Flow

- Redirect URL: http://localhost:3005/callback

1. Copy Client ID and Client Secret

In Snow-Flow TUI:

```

/auth

```

Follow the prompts to enter your instance URL and OAuth credentials.

---

Snow-Flow supports 75+ AI providers. Configure via environment variables or /auth:

Claude (Recommended)

```bash

export ANTHROPIC_API_KEY=sk-ant-api03-...

```

Or use Claude Pro/Max subscription via browser auth.

OpenAI

```bash

export OPENAI_API_KEY=sk-...

```

Google Gemini

```bash

export GOOGLE_API_KEY=AIza...

```

100% Free -