ServiceNow

A Model Context Protocol (MCP) server implementation for ServiceNow, enabling AI assistants like Claude to interact with ServiceNow instances through the ServiceNow API.

Features

• Multiple Authentication Methods: Supports Basic, OAuth, and API Key authentication
• Incident Management: Create, update, resolve, and list incidents; add comments
• Service Catalog: Browse items, manage categories, create/update variables, move items between categories
• Catalog Optimization: Get recommendations for improving service catalog structure and content
• Change Management: Create, update, approve/reject change requests; manage change tasks and approvals
• Agile Management: Full support for user stories, epics, scrum tasks, projects, and dependencies
• Workflow Management: List, create, update, and delete workflows
• Script Includes: Manage server-side scripts
• Changeset Management: Create, commit, publish changesets; add files to changesets
• Knowledge Base: Create knowledge bases, categories, and articles; publish articles
• User Management: Create/update users and groups; manage group membership
• UI Policies: Create UI policies and actions to control form field behavior
• Tool Packaging: Load subsets of tools based on role (service_desk, catalog_builder, change_coordinator, knowledge_author, platform_developer, system_administrator, agile_management)
• Multiple Transport Options: Supports both stdio and Server-Sent Events (SSE) modes
• Debug Mode: Built-in troubleshooting support

Tool Packaging

Control which tools are exposed using the MCP_TOOL_PACKAGE environment variable. Available packages:

• service_desk: Incident handling and basic user/knowledge lookup
• catalog_builder: Service catalog management and scripting
• change_coordinator: Change request lifecycle management
• knowledge_author: Knowledge base and article management
• platform_developer: Server-side scripting and workflow development
• system_administrator: User/group management and system logs
• agile_management: User stories, epics, scrum tasks, and projects
• full: All tools (default)
• none: No tools except list_tool_packages

Available Tools

Incident Management

• create_incident, update_incident, add_comment, resolve_incident, list_incidents

Service Catalog

• list_catalog_items, get_catalog_item, list_catalog_categories, create_catalog_category, update_catalog_category, move_catalog_items, create_catalog_item_variable, list_catalog_item_variables, update_catalog_item_variable, list_catalogs

Catalog Optimization

• get_optimization_recommendations, update_catalog_item

Change Management

• create_change_request, update_change_request, list_change_requests, get_change_request_details, add_change_task, submit_change_for_approval, approve_change, reject_change

Agile Management

• create_story, update_story, list_stories, create_story_dependency, delete_story_dependency, create_epic, update_epic, list_epics, create_scrum_task, update_scrum_task, list_scrum_tasks, create_project, update_project, list_projects

Workflow Management

• list_workflows, get_workflow, create_workflow, update_workflow, delete_workflow

Script Includes

• list_script_includes, get_script_include, create_script_include, update_script_include, delete_script_include

Changeset Management

• list_changesets, get_changeset_details, create_changeset, update_changeset, commit_changeset, publish_changeset, add_file_to_changeset

Knowledge Base

• create_knowledge_base, list_knowledge_bases, create_category, create_article, update_article, publish_article, list_articles, get_article

User Management

• create_user, update_user, get_user, list_users, create_group, update_group, add_group_members, remove_group_members, list_groups

UI Policies

• create_ui_policy, create_ui_policy_action

SSE Mode

The server can also run as a web server using Server-Sent Events (SSE) for communication:

servicenow-mcp-sse --instance-url=https://your-instance.service-now.com --username=your-username --password=your-password

By default, the SSE server listens on 0.0.0.0:8080. Customize with --host and --port flags.

Authentication

Three authentication methods are supported:

• Basic: Username and password
• OAuth: Client ID, client secret, and token URL
• API Key: API key header authentication