This project is a test to see how I can develop for ServiceNow using VS Code instead of working directly in the ServiceNow web interface. The main goal is to try out Claude Code as an AI partner to see how much it can help me write and build applications faster.
This application is developed using the ServiceNow SDK, VS Code, and Claude Code. It utilizes React with Fluent UI (ready-to-use building blocks, like buttons, lists, etc) for the frontend and TypeScript for server-side logic.
-
Node.js: Version v20.x.x or higher is required.
-
ServiceNow SDK: Install the SDK globally so the
now-sdkCLI is available from any directory.
Can be installed via:
npm install -g @servicenow/sdkVerify version (expected output: 4.4.0 or later):
now-sdk --version- Claude Code: Requires a Claude Pro, Max, or Team subscription. When installed locally, it can be installed via:
npm install -g @anthropic-ai/claude-code- ServiceNow PDI (Personal Developer Instance): Can be ordered for free on https://developer.servicenow.com/.
git clone https://github.com/youraccount/your-project-name.git
cd your-project-namenpm installTo check version:
npm --versionTo connect the project to your ServiceNow Personal Developer Instance (PDI). The PDI example https://dev123456.service-now.com/, and it must be active (ensure you are logged in to the developer portal):
now-sdk auth --add dev123456 --type oauthFollow the prompts in your browser to complete the OAuth authentication process. Copy the code provided in the browser.
Please note: When pasting the code into the terminal, the characters will not be visible. Paste it once and press Enter.
A "skill" is a knowledge file that teaches Claude Code (AI) about the ServiceNow SDK and Fluent API. Follow these steps to install it:
- Create the skills directory:
mkdir -p ~/.claude/skills/sndev- Create a skill file:
touch ~/.claude/skills/sndev/SKILL.mdI've used the following skill as template for this project:
Tutorial instructions and skills/SKILL.md
To initialize the AI assistant:
claudeType: "What ServiceNow SDK commands do you know?" to see if it lists the correct commands e.g. now-sdk build, now-sdk deploy and/or now-sdk auth
To deploy your local code changes to the connected ServiceNow instance, execute the following command:
now-sdk deploy- src/fluent/: Contains metadata and server-side logic defined in TypeScript.
- src/client/: Contains React components and Fluent UI assets for the user interface.
- now.config.json: Configuration settings for the ServiceNow instance connection.