================================================================================
                    ServiceNow MCP Server - PROD-9845
================================================================================

SUMMARY
-------
A read-only MCP server that enables Claude (Desktop and Code) to query
ServiceNow ITSM data using OAuth 2.0 browser authentication with Okta SSO.
Users access ServiceNow with their own credentials and permissions - no
elevated access.

INSTANCE
--------
Dev Instance:    vituitydev.service-now.com
Change Request:  CHG0039169

AUTHENTICATION
--------------
- OAuth 2.0 Authorization Code flow with PKCE
- Automatic Okta SSO redirect
- Tokens cached locally, auto-refresh

AVAILABLE TOOLS (22)
--------------------

User
  - get_current_user          Get authenticated user info

ITSM
  - get_incident              Get incident by number (INC) or sys_id
  - query_incidents           Search incidents with filters
  - get_change_request        Get change by number (CHG) or sys_id
  - query_change_requests     Search change requests with filters
  - get_problem               Get problem by number (PRB) or sys_id
  - query_problems            Search problems with filters

Service Catalog
  - get_request               Get request by number (REQ) or sys_id
  - query_requests            Search requests with filters
  - get_request_item          Get request item by number (RITM) or sys_id
  - query_request_items       Search request items with filters
  - get_catalog_task          Get catalog task by number (SCTASK) or sys_id
  - query_catalog_tasks       Search catalog tasks with filters

CMDB
  - get_configuration_item    Get CI by name or sys_id
  - query_configuration_items Query CIs with filters (max 200 results)
  - search_configuration_items Search CIs by name, IP, serial, asset tag, FQDN
  - export_configuration_items Export all matching CIs to CSV/JSON (up to 10k)

Knowledge Base
  - get_kb_article            Get article by number (KB) or sys_id
  - query_kb_articles         Query articles with filters
  - search_kb_articles        Full-text search in KB title and content

Release Management
  - get_release               Get release by number (RL) or sys_id
  - query_releases            Query releases with filters

EXAMPLE PROMPTS
---------------
  "Who am I in ServiceNow?"
  "Show me my open incidents"
  "Get incident INC0012345"
  "List P1 incidents assigned to my team"
  "What changes are scheduled this week?"
  "Show my open RITMs"
  "List production servers in CMDB"
  "Export all Windows servers to CSV"
  "Search KB for password reset"
  "Show releases in planning state"
  "Get release RL0010001"

SETUP INSTRUCTIONS
------------------

1. Install dependencies (one time):
   cd C:\servicenow-mcp
   npm install

2. Authenticate via browser (tokens expire, re-run as needed):
   npm run auth

3. Add to Claude Desktop config:

   Location: %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "servicenow": {
         "command": "node",
         "args": ["C:\\Users\\<YOUR_USERNAME>\\code\\PROD-9845\\dist\\index.js"],
         "env": {
           "SERVICENOW_INSTANCE_URL": "https://vituitydev.service-now.com",
           "SERVICENOW_CLIENT_ID": "<client_id>",
           "SERVICENOW_CLIENT_SECRET": "<client_secret>"
         }
       }
     }
   }

4. Restart Claude Desktop

5. Test by asking: "Who am I in ServiceNow?"

CONTACT
-------
For setup assistance or issues, contact the project team.

PROJECT LOCATION
----------------
C:\servicenow-mcp\

Full setup guide: C:\servicenow-mcp\SETUP.md
Developer docs:   C:\servicenow-mcp\README.md

STATUS
------
Testing - Release management tools added
Remaining: Rotate client secret, deploy to production, distribute setup guide

================================================================================
                         Generated: 2026-01-27
================================================================================
