# servicenow-mcp-ai > An MCP server that connects any MCP client — Claude Desktop, Claude Code, VS Code Copilot Chat, Cursor — to a ServiceNow instance over its REST APIs. Every write is previewed first, a destructive one needs a single-use plan token, and record writes are journaled and can be reverted. Alongside that comes IDE-grade code intelligence: find usages, what runs on save, and drift between instances. Free and local, and it works on your PDI. 100 tools in 28 packages: 20 load by default and SN_TOOL_PACKAGES adds the rest, so the tool list stays small in tokens. It is an independent community project and is not affiliated with ServiceNow, Inc. Install it with `npx -y servicenow-mcp-ai`. Run `npx servicenow-mcp-ai init` for a guided setup and `npx servicenow-mcp-ai doctor` for diagnostics. Tools come in packages that you select with `SN_TOOL_PACKAGES`. Writes are governed by `SN_WRITE_MODE` and the policy settings. Every environment setting is documented in the README's "Environment variables" section, which is generated from the settings manifest. ## Docs - [README](https://github.com/IvanBBaev/servicenow-mcp-ai#readme): install, client setup, the tool reference per package, and the environment variable reference - [.env.example](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/.env.example): every setting with its default, grouped by section - [SECURITY.md](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/SECURITY.md): the credential handling, policy and write-safety model - [CHANGELOG.md](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/CHANGELOG.md): release notes, unreleased changes included - [Changelog page](https://ivanbbaev.github.io/servicenow-mcp-ai/changelog.md): the released versions, as Markdown on the documentation site - [Architecture](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/project/ARCHITECTURE.md): the layers, ports and adapters, and the request pipeline ## Tool reference - [Full documentation in one file](https://ivanbbaev.github.io/servicenow-mcp-ai/llms-full.txt): README, SECURITY and the tool reference - [Documentation site as Markdown](https://ivanbbaev.github.io/servicenow-mcp-ai/index.md): the landing page without the markup - [Tool reference index](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/README.md): packages and error codes - [table](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/table.md): 6 tools - [schema](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/schema.md): 2 tools - [aggregate](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/aggregate.md): 1 tool - [attachment](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/attachment.md): 5 tools - [importset](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/importset.md): 2 tools - [batch](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/batch.md): 1 tool - [catalog](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/catalog.md): 5 tools - [change](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/change.md): 5 tools - [knowledge](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/knowledge.md): 3 tools - [cmdb](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/cmdb.md): 7 tools - [scripts](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/scripts.md): 5 tools - [flows](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/flows.md): 5 tools - [codecheck](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/codecheck.md): 3 tools - [docs](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/docs.md): 9 tools - [instance](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/instance.md): 3 tools - [email](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/email.md): 2 tools - [atf](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/atf.md): 3 tools - [revert](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/revert.md): 2 tools - [artifacts](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/artifacts.md): 5 tools - [updatesets](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/updatesets.md): 3 tools - [cicd](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/cicd.md): 1 tool - [access](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/access.md): 1 tool - [ops](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/ops.md): 2 tools - [history](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/history.md): 2 tools - [properties](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/properties.md): 2 tools - [directory](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/directory.md): 2 tools - [ui](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/ui.md): 2 tools - [admin](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/docs/tools/admin.md): 11 tools ## Distribution - [npm package](https://www.npmjs.com/package/servicenow-mcp-ai): `servicenow-mcp-ai` - [MCP registry entry](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/server.json): `io.github.IvanBBaev/servicenow-mcp-ai` - [Landing page](https://ivanbbaev.github.io/servicenow-mcp-ai/) - [Claude Code plugin](https://github.com/IvanBBaev/servicenow-mcp-ai/tree/main/.claude-plugin): `/plugin marketplace add IvanBBaev/servicenow-mcp-ai`, then `/plugin install servicenow-mcp-ai`; the server wired up plus skills, subagents and hooks - [VS Code extension](https://github.com/IvanBBaev/servicenow-mcp-ai/tree/main/extension): `ivanbbaev.servicenow-mcp-ai`; registers the server in Copilot Chat with no `mcp.json` - [MCP bundle (.mcpb)](https://github.com/IvanBBaev/servicenow-mcp-ai/releases/latest): one-click Claude Desktop install; `servicenow-mcp-ai-.mcpb` is attached to every GA release (build it yourself with `npm run mcpb:pack`) - [Skills](https://github.com/IvanBBaev/servicenow-mcp-ai/tree/main/skills): eight workflow skills (`sn-discover`, `sn-drift`, `sn-impact`, `sn-safe-write`, `sn-security`, `sn-triage`, `sn-uib`, `sn-upgrade`), usable from Claude Code, Copilot, Codex and Cursor ## Optional - [CONTRIBUTING.md](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/CONTRIBUTING.md): the build, the test and quality gates, and the release process - [Product state](https://github.com/IvanBBaev/servicenow-mcp-ai/blob/main/project/ROADMAP-V3.md): what is shipped and what is planned