logo

NJP

Quick Tutorial: MCP Client to ServiceNow HRSD MCP Server Knowledge Tool

New article articles in ServiceNow Community · Aug 20, 2026 · article

In this tutorial, we’re going to go over MCP client setup to connect to a ServiceNow MCP Server via OAuth 2.0. I’m going to use the HRSD MCP Server (released August 2026) and demo the use case against the HR Knowledge Search tool.

 

I’m going to use the following MCP clients:

  • Claude Desktop
  • Postman

Microsoft Copilot Studio Agents was previously covered in another tutorial. ChatGPT Codex doesn’t currently seem to support direct OAuth configuration, so I won’t include that example here.

 

Prerequisites

For this tutorial, I’m running the following setup:

  • Australia Patch 5 W33
  • ServiceNow Otto Platform Prime [sn_ai_plat_prm] 2.2.0
  • Model Context Protocol Server [sn_mcp_server] 1.7.2
  • HRSD MCP Server [sn_hr_mcp_server] 1.0.2
  • Claude Desktop version 1.32885.1 (a757f5) on Windows 11, with a Free plan
  • Postman 12.23.2 on MacOS Tahoe 26.5.2

Activate HRSD MCP Server

In ServiceNow, login as a System Administrator [admin]. Go to Admin Center > MCP Server Console :

 

warren_chan_0-1787241120522.png

 

Under Servers , verify that HRSD MCP Server is Active :

 

warren_chan_1-1787241141468.png

 

If it is not active, hit the ... icon to the right and select Activate :

 

warren_chan_2-1787241167827.png

 

Select the HRSD MCP Server , and review the available Tools :

 

warren_chan_3-1787241185961.png

 

We’ll target the HR Knowledge Search tool for demonstration purposes of this tutorial.

 

Set up OAuth for MCP Client

Under OAuth setup required , select the Set up OAuth button:

 

warren_chan_4-1787241213157.png

 

This should open a new browser tab to the Inbound Integrations tab of the Machine Identity Console workspace/experience. Select New integration :

 

warren_chan_5-1787241235034.png

 

Under Select your application connection type , pick OAuth – Authorization code grant :

 

warren_chan_6-1787241257428.png

 

Create a new Inbound integration for OAuth with Authorization code by filling out the Name and Provider name. The Client ID and Client secret should be automatically generated. Make sure Active is selected.

 

warren_chan_7-1787241276337.png

 

For Claude Desktop or Claude AI, use the following Redirect URLs (I put both in, comma-delimited):

 

https://claude.ai/api/mcp/auth\_callback,https://claude.com/api/mcp/auth\_callback

 

Set the Auth scope to useraccount or something of lesser permission. The useraccount Auth scope will, by default, grant all permissions that the authenticated user has. Be mindful of what this means for a production scenario!

 

warren_chan_8-1787241332893.png

 

Under Advanced options , I set the Token Format to JWT , although Claude seems to take both Opaque or JWT:

 

warren_chan_9-1787241361264.png

 

Save the OAuth Inbound Integration application registry record.

 

From Claude Desktop

Open Claude Desktop. From your user profile, go to Settings > Connectors > Add > Add custom connector :

 

warren_chan_10-1787241383722.png

 

In the Add custom connector modal, enter your MCP server name and URL :

 

warren_chan_11-1787241400643.png

 

Select Continue. Under the Authentication settings, select Always required. Under OAuth client , select Use your own OAuth client. At the bottom, select Add.

 

warren_chan_12-1787241416942.png

 

On the next screen, enter your ServiceNow Inbound Integration’s OAuth Client ID and OAuth Client Secret. At the bottom, select Add.

 

You are returned to the Connectors screen:

 

warren_chan_13-1787241445321.png

 

Select the Connect button. This should launch an authentication window in your browser.

 

warren_chan_14-1787241469471.png

 

Select Allow. Afterwards, the redirect should go back to Claude Desktop. You should see the MCP server connected, with the Tools listed. You can set granular permissions for these Tools here in Claude Desktop.

 

warren_chan_15-1787241486932.png

 

warren_chan_16-1787241503429.png

 

Exit the Settings and start a new chat in Claude. Ask something like: What are my tools for the HRSD MCP Server?

 

warren_chan_17-1787241525873.png

 

Your Tools list should be returned. Ask for HR Knowledge afterwards: Tell me about my organization’s spam policy.

 

warren_chan_18-1787241543448.png

 

If you are prompted to run the Tool, select Allow once.

 

warren_chan_19-1787241567167.png

 

The HR Knowledge Search Tool should run, and a response returned from the Knowledge Base.

 

warren_chan_20-1787241588827.png

 

That’s it for Claude Desktop.

 

From Postman

Following earlier steps, set up a separate OAuth Inbound Integration application registry for Postman. Note that Postman has a different Redirect URL endpoint than Claude:

 

https://oauth.pstmn.io/v1/callback

 

warren_chan_21-1787241615539.png

 

Set Auth scope to useraccount. Again, be mindful of the Auth scope considerations:

 

warren_chan_22-1787241674994.png

 

I believe that the Token Format must be JWT for Postman:

 

warren_chan_23-1787241699568.png

 

Save the OAuth Inbound Integration application registry record.

 

Open your Postman client. Create a new POST request. Under Authorization , fill in the following field values:

 

Under POST

  • URL: https://<your instance name>.service-now.com/sncapps/mcp-server/mcp/sn_hr_mcp_server_hr_default
  • Auth type: OAuth 2.0
  • Add authorization to: Request headers

Under Configure New Token

  • Token Name: Postman Token
  • Grant type: Authorization Code
  • Callback URL: https://oauth.pstmn.io/v1/callback
  • Authorize using browser: (checked)
  • Auth URL: https://<your instance name>.service-now.com/oauth_auth.do
  • Access Token URL: https://<your instance name>.service-now.com/oauth_token.do
  • Client ID: <from ServiceNow OAuth Inbound Integration app registry>
  • Client Secret: <from ServiceNow OAuth Inbound Integration app registry>
  • Scope: useraccount
  • State: state100
  • Client Authentication: Send as Basic Auth header

warren_chan_24-1787241742642.png

 

At the bottom of the Authorization tab, select Get new access token. You should see a popup window appear:

 

warren_chan_25-1787241763246.png

 

warren_chan_26-1787241776499.png

 

You’ll be redirected to the instance to allow the connection:

 

warren_chan_27-1787241801079.png

 

Select Allow to continue. Postman should receive the authenticated call, and you should have a token in Postman:

 

warren_chan_28-1787241817450.png

 

Under Manage Tokens , select Use Token :

 

warren_chan_29-1787241831592.png

 

Next, the Accept header must align to the MCP standards. In the Headers tab, change your Accept Key value to be application/json, text/event-stream. If you have another Accept Key already generated with value */* , uncheck that row, and insert a new row:

 

warren_chan_30-1787241851115.png

 

To kick things off, you can send a initialize call. The current MCP version I have today is 2025-06-18, but the initialize process is removed in later versions of MCP, starting in the 2026-07-28 specification.

 

In the Body tab, insert the following and send:

 

{ "jsonrpc": "2.0", "id": 1, "method": "initialize", "params": { "protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": { "name": "postman-test", "version": "1.0.0" } } }

 

warren_chan_31-1787241928531.png

 

The initialize response:

 

warren_chan_32-1787241950240.png

 

Next, in the Body tab, insert your tools/list call. This will list the Tools that the ServiceNow MCP Server is offering up:

 

{ "jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {} }

 

warren_chan_33-1787241987387.png

 

Select Send to send your request to the ServiceNow MCP Server. Review the response that you get back:

 

warren_chan_34-1787242008890.png

 

Finally, let’s construct a payload that invokes the Tool for HR Knowledge Search. In the Body tab, insert the following, and send the request:

 

{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "hr_knowledge_search", "arguments": { "query": "Tell me about my organization's spam policy." } } }

 

warren_chan_35-1787242047702.png

 

Here’s the response:

 

warren_chan_36-1787242072201.png

 

There you have it, Postman to ServiceNow MCP Server connection validated.

 

Resources

HRSD MCP Server:

https://www.servicenow.com/docs/r/employee-service-management/now-assist-for-hrsd/hrsd-mcp-server.html?contentId=nxThgJeQe_UgXuTHFAuuYA

 

Claude Desktop to Service Mapping MCP Server: https://www.servicenow.com/docs/r/zurich/it-operations-management/service-mapping/connect-claude-desktop-sm-mcp.html

View original source

https://www.servicenow.com/community/servicenow-otto-articles/quick-tutorial-mcp-client-to-servicenow-hrsd-mcp-server/ta-p/3589606