This is a work in progress. Right now none of the tools are implemented. The goal is to create a Model Context Protocol (MCP) server that can be used with ServiceNow on out of box instances. This will allow you to use AI tools in ServiceNow without having to write any code in things like Open Web UI.

Want to learn more about the Model Context Protocol? Check out the following resources:

• Model Context Protocol Specification
• FreeCodeCamp's How to Build a Custom MCP Server with TypeScript
• YouTube Video: How to Build a Custom MCP Server with TypeScript

Note, This is inspired by the project at https://github.com/echelon-ai-labs/servicenow-mcp. I like what they did but I wanted it in the TypeScript style that I use in my other projects. Also Typescript is a lot closer to JavaScript and JavaScript is what's used in ServiceNow.

• Node.js
• A ServiceNow Instance

git clone https://github.com/jacebenson/ai-mcp-servicenow.git
cd ai-mcp-servicenow
npm install

Create a .env file in the root directory with the following content:

SERVICENOW_INSTANCE_URL=https://dev12345.service-now.com
SERVICENOW_USERNAME=admin
SERVICENOW_PASSWORD=your_password_here

Standard (stdio) Mode

I've mapped these to scripts in the package.json file so you can run them with npm run server or npm run dev or npm run inspector.

However you can also run them directly with npx if you prefer.

To start the MCP server in standard mode, run:

npx -y @modelcontextprotocol/inspector npx -y tsx main.ts
# or
npm run server

To start the MCP server in inspector mode, run:

npx -y @modelcontextprotocol/inspector npx -y tsx main.ts --inspector
# or
npm run inspector

I've included a tool, ./tools/get-weather.js, that demonstrates how to create a tool for the MCP server. You can use this as a starting point for creating your own tools, or the tools I've spelled out in the ./main.ts file.