ServiceNow MCP Server


A comprehensive Model Context Protocol (MCP) server for ServiceNow ITSM with browser-based SSO authentication support.

> Perfect for enterprise environments - No API keys required. Works with Okta, Azure AD, and any SSO provider.

Features

- Browser Authentication: Log in via your enterprise SSO (Okta, Azure AD, etc.) - no API keys needed
- 70+ Tools: Incidents, Changes, Problems, Catalog, CMDB, Knowledge Base, Users, Approvals, and more
- GraphQL & REST Support: Works with both ServiceNow APIs
- Session Management: Automatic cookie handling and refresh

Installation

$3

``bash
npm install servicenow-mcp
`

Or install globally:

`bash
npm install -g servicenow-mcp
`

$3

Linux/macOS:

`bash
git clone https://github.com/schwarztim/servicenow-mcp.git
cd servicenow-mcp
npm install
npm run build
`

Windows:

`powershell
git clone https://github.com/schwarztim/servicenow-mcp.git
cd servicenow-mcp
.\scripts\install.ps1
`

> 📝 Windows Users: See WINDOWS.md for detailed Windows installation guide, including path configuration, PowerShell setup, and troubleshooting.

Authentication Methods

$3

Use the auth_browser tool from Claude:

`
> Use auth_browser to log into ServiceNow

A browser will open. Log in with your SSO credentials.
Cookies are automatically captured and saved.
`

Or from command line:

`bash
npm run auth https://yourinstance.service-now.com
`

$3

Set environment variables:

`bash
export SERVICENOW_INSTANCE_URL="https://yourinstance.service-now.com"
export SERVICENOW_USERNAME="your-username"
export SERVICENOW_PASSWORD="your-password"
`

$3

For GraphQL API access:

`bash
export SERVICENOW_INSTANCE_URL="https://yourinstance.service-now.com"
export SERVICENOW_SESSION_TOKEN="your-session-cookie"
export SERVICENOW_USER_TOKEN="your-g_ck-token"
`

Usage with Claude

After browser authentication:

`
> List open P1 incidents
> Show me change CHG0012345
> Create an incident for "Email server down"
> Search CMDB for servers in the Atlanta datacenter
`

Available Tools

$3

- incidents_list - List incidents with filtering
- incidents_get - Get incident details
- incidents_create - Create new incident
- incidents_update - Update incident
- incidents_resolve - Resolve incident

$3

- changes_list - List change requests
- changes_get - Get change details
- changes_create - Create change request
- changes_tasks - Get change tasks

$3

- catalog_items - Browse catalog items
- catalog_item_get - Get item details
- catalog_order - Order catalog item
- catalog_requests - List requests

$3

- cmdb_list - Query configuration items
- cmdb_get - Get CI details
- cmdb_relationships - View CI relationships
- cmdb_create - Create CI

$3

- kb_search - Search knowledge articles
- kb_article_get - Get article content

$3

- users_search - Search users
- user_get - Get user details
- groups_list - List groups
- group_members - Get group members

$3

- Approvals, SLAs, Workflows, Email, Events, Audit, Update Sets, Security ACLs, Discovery, etc.

Configuration

Add to your Claude configuration file:

Linux/macOS: ~/.claude/user-mcps.json
Windows: %USERPROFILE%\.claude\user-mcps.json

`json
{
"mcpServers": {
"servicenow": {
"command": "node",
"args": [
"/Users/yourname/Scripts/mcp-servers/servicenow-mcp/dist/index.js"
],
"env": {
"SERVICENOW_INSTANCE_URL": "https://yourinstance.service-now.com"
}
}
}
}
`

Windows users: Use double backslashes in paths:

`json
"args": ["C:\\Users\\YourName\\servicenow-mcp\\dist\\index.js"]
`

Or use forward slashes (also works on Windows):

`json
"args": ["C:/Users/YourName/servicenow-mcp/dist/index.js"]
`

Troubleshooting

$3

Run auth_browser tool or set environment variables.

$3

Browser cookies are valid for ~8 hours. Re-run auth_browser` to refresh.

$3

Ensure your ServiceNow user has appropriate roles (itil, admin, etc.).

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

Support

- Issues: GitHub Issues
- Discussions: GitHub Discussions

Acknowledgments

- Built with @modelcontextprotocol/sdk
- Browser automation powered by Playwright

License

MIT © Timothy Schwarz - see LICENSE for details