# PDI Bridge for Claude

> **Connect Claude Desktop to your ServiceNow PDI** — query records, inspect Business Rules, review ACLs, and troubleshoot against your live instance.

[![Version](https://img.shields.io/badge/version-1.2.5-blue)](https://github.com/jxrlabs/pdi-bridge-for-claude/releases)
[![License](https://img.shields.io/badge/license-Proprietary-red)](LICENSE.txt)
[![MCP](https://img.shields.io/badge/MCP-Compatible-green)](https://modelcontextprotocol.io)

## What it does

PDI Bridge is a local MCP server that gives Claude Desktop a live, authenticated connection to your ServiceNow Personal Developer Instance (PDI).

**Instead of copying and pasting records into Claude**, you can ask Claude to pull the data directly:

- Query any table with encoded queries
- Review Business Rules, ACLs, Client Scripts, and Script Includes
- Get individual records by sys_id
- Optionally create and update records (disabled by default)

## Installation

PDI Bridge is available for macOS, Windows, and Linux.

👉 **[Get PDI Bridge on Gumroad](https://jxrlabs.gumroad.com/l/servicenow-pdi-bridge-claude)**

Includes:
- Standalone executable (no Node.js required)
- One-click browser setup wizard
- Read + write tools
- Full table access
- Commercial license

## Requirements

- Claude Desktop (macOS, Windows, or Linux)
- A ServiceNow PDI or non-production sandbox
- Admin or security_admin role on the instance (for script inspection)

## MCP Configuration

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "servicenow-pdi-bridge": {
      "command": "/path/to/pdi-bridge",
      "env": {
        "SN_INSTANCE": "dev12345.service-now.com",
        "SN_USERNAME": "admin",
        "SN_PASSWORD": "your-password",
        "ENABLE_WRITE": "false"
      }
    }
  }
}
```

**macOS config location:** `~/Library/Application Support/Claude/claude_desktop_config.json`

## Example Prompts

**Exploring configuration:**
- "Show me all active Business Rules on the incident table"
- "List the ACLs on the sys_user table, including field-level ones, and tell me which ones restrict read access"
- "Get the IncidentUtils Script Include and explain what it does"

**Troubleshooting:**
- "I'm getting an unexpected null on the caller field when an incident is created via the portal. Check the Business Rules and Client Scripts on the incident table and help me figure out why."
- "A user with the itil role can't see certain incidents. Pull the ACLs on the incident table and help me understand why."

**Data lookups:**
- "Query the 10 highest priority open incidents and summarize them"
- "Find the sys_user record for [username] and tell me their roles"

## Tools

| Tool | Description | Default |
|------|-------------|---------|
| `query_records` | Query any table with an encoded query | ✅ Always |
| `get_record` | Fetch one record by sys_id | ✅ Always |
| `list_business_rules` | List Business Rules, filtered by table | ✅ Always |
| `list_acls` | List ACL rules (table + field level) | ✅ Always |
| `list_client_scripts` | List Client Scripts, filtered by table | ✅ Always |
| `get_script_include` | Fetch a Script Include by name | ✅ Always |
| `create_record` | Create a new record | ❌ Opt-in |
| `update_record` | Update fields on a record | ❌ Opt-in |

## Security

- Credentials stored locally in a `.env` file (base64-encoded, not encrypted)
- Write tools are **disabled by default** — must be explicitly enabled
- No delete tool included
- All communication is HTTPS directly to your instance
- Designed for PDIs, not production instances

## Marketplace Listings

- [MCP.so](https://mcp.so/servers/pdi-bridge-for-claude)
- [Smithery](https://smithery.ai)
- [Glama](https://glama.ai)

## Support

- Product support: [support@jxrlabs.app](mailto:support@jxrlabs.app)
- Sales/licensing: [sales@jxrlabs.app](mailto:sales@jxrlabs.app)

## Disclaimer

ServiceNow® is a trademark of ServiceNow, Inc. Claude™ is a trademark of Anthropic, PBC. This is an independent product not affiliated with either company.

---

© 2026 JXR Labs LLC. All rights reserved.