{"_id":"@imazhar101/salesforce-mcp-jsforce","_rev":"8-28d6460ad8dd922fae3c6a4058ec2ba7","name":"@imazhar101/salesforce-mcp-jsforce","dist-tags":{"latest":"0.5.2"},"versions":{"0.1.0":{"name":"@imazhar101/salesforce-mcp-jsforce","version":"0.1.0","keywords":["mcp","model-context-protocol","salesforce","jsforce","claude","oauth"],"author":{"name":"imazhar101"},"license":"MIT","_id":"@imazhar101/salesforce-mcp-jsforce@0.1.0","maintainers":[{"name":"imazhar101","email":"imazhar101@gmail.com"}],"homepage":"https://github.com/imazhar101/salesforce-mcp-jsforce#readme","bugs":{"url":"https://github.com/imazhar101/salesforce-mcp-jsforce/issues"},"bin":{"salesforce-mcp-jsforce":"dist/index.js"},"dist":{"shasum":"293db541642d1c9445a5e16af4303716fa9f79ec","tarball":"https://registry.npmjs.org/@imazhar101/salesforce-mcp-jsforce/-/salesforce-mcp-jsforce-0.1.0.tgz","fileCount":24,"integrity":"sha512-+eJe7xXA7zs8Vv7DSaK7x5RW7cWIKVMWqgeC1bS/JWte0b1cQBMn5XxcGpL1N5iG1xEI3otRKyk6HIjF14gb2Q==","signatures":[{"sig":"MEQCIALDBUErypH3CWNxjcPawn2DsPPrUkLQTaj/xgTXytCAAiAbky6GVkgn1EQDHH+S9r2aCjZF5dDlgNXGSDpPxO7wOw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60371},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"b2d33aa9d297c799cc65cbd81404176dd5aa9616","scripts":{"dev":"tsx src/index.ts","http":"tsx src/index.ts http","build":"tsc","login":"tsx src/index.ts login","prepublishOnly":"npm run build"},"_npmUser":{"name":"imazhar101","email":"imazhar101@gmail.com"},"repository":{"url":"git+https://github.com/imazhar101/salesforce-mcp-jsforce.git","type":"git"},"_npmVersion":"11.6.1","description":"A lite, single-org Salesforce MCP server built on jsforce. Bring-your-own OAuth token — no credentials stored server-side. Runs over stdio (Claude Code) or as a dedicated streamable-HTTP server.","directories":{},"_nodeVersion":"24.10.0","dependencies":{"zod":"^3.23.8","jsforce":"^3.6.3","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.0","typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/salesforce-mcp-jsforce_0.1.0_1781847071327_0.15349342444334924","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@imazhar101/salesforce-mcp-jsforce","version":"0.2.0","keywords":["mcp","model-context-protocol","salesforce","jsforce","claude","oauth"],"author":{"name":"imazhar101"},"license":"MIT","_id":"@imazhar101/salesforce-mcp-jsforce@0.2.0","maintainers":[{"name":"imazhar101","email":"imazhar101@gmail.com"}],"homepage":"https://github.com/imazhar101/salesforce-mcp-jsforce#readme","bugs":{"url":"https://github.com/imazhar101/salesforce-mcp-jsforce/issues"},"bin":{"salesforce-mcp-jsforce":"dist/index.js"},"dist":{"shasum":"adb12b235a199c55cfc8ff5b80e46b35dccb4b35","tarball":"https://registry.npmjs.org/@imazhar101/salesforce-mcp-jsforce/-/salesforce-mcp-jsforce-0.2.0.tgz","fileCount":24,"integrity":"sha512-Qwa2fLthi0QD4Y27wlJPMNNETkBmf17RIoP+sb82MtYxVBviJuLk8dwCq71r5IQyMRY6S6Q8ZxRxHtumXqhDow==","signatures":[{"sig":"MEUCIQDNb5eG3BU5uyTFL9/kKhRZDN9FdkRQ8dvQc2sp4qAbXQIgM3JWV+CcSKq2bs+YoqqAttg1jYNBJU1XbA/R2+LUGeg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@imazhar101%2fsalesforce-mcp-jsforce@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":62497},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"d1bd04467985dd21753bf2721a8ad9253de31bf7","scripts":{"dev":"tsx src/index.ts","http":"tsx src/index.ts http","build":"tsc","login":"tsx src/index.ts login","prepublishOnly":"npm run build"},"_npmUser":{"name":"imazhar101","email":"imazhar101@gmail.com"},"repository":{"url":"git+https://github.com/imazhar101/salesforce-mcp-jsforce.git","type":"git"},"_npmVersion":"10.8.2","description":"A lite, single-org Salesforce MCP server built on jsforce. Bring-your-own OAuth token — no credentials stored server-side. Runs over stdio (Claude Code) or as a dedicated streamable-HTTP server.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.8","jsforce":"^3.6.3","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.0","typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/salesforce-mcp-jsforce_0.2.0_1781850783746_0.43656579760206227","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@imazhar101/salesforce-mcp-jsforce","version":"0.3.0","keywords":["mcp","model-context-protocol","salesforce","jsforce","claude","oauth"],"author":{"name":"imazhar101"},"license":"MIT","_id":"@imazhar101/salesforce-mcp-jsforce@0.3.0","maintainers":[{"name":"imazhar101","email":"imazhar101@gmail.com"}],"homepage":"https://github.com/imazhar101/salesforce-mcp-jsforce#readme","bugs":{"url":"https://github.com/imazhar101/salesforce-mcp-jsforce/issues"},"bin":{"salesforce-mcp-jsforce":"dist/index.js"},"dist":{"shasum":"6fc88c6a463c36bd4450443dbbd27e609a475a25","tarball":"https://registry.npmjs.org/@imazhar101/salesforce-mcp-jsforce/-/salesforce-mcp-jsforce-0.3.0.tgz","fileCount":24,"integrity":"sha512-dJCrfXQ3rL6VNyhmtNaNiXAfElc+HUgK79AML8FcP4U1h0sRTsCARoh28hHi/pGY+Xz0yzNXAfu8FBwdpM+KSQ==","signatures":[{"sig":"MEYCIQDpUY7XlbxGA7np4xsGR8O2/vQMxLC83WDOT9n1d18pJQIhAIiZrd5fn4gSJvR+ssQxy6PrWNjYwCoJXH6wHsNB+jyY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@imazhar101%2fsalesforce-mcp-jsforce@0.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":63059},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"e937f1cbc1b0f375c722f79a45e86890c7dcc803","scripts":{"dev":"tsx src/index.ts","http":"tsx src/index.ts http","build":"tsc","login":"tsx src/index.ts login","prepublishOnly":"npm run build"},"_npmUser":{"name":"imazhar101","email":"imazhar101@gmail.com"},"repository":{"url":"git+https://github.com/imazhar101/salesforce-mcp-jsforce.git","type":"git"},"_npmVersion":"10.8.2","description":"A lite, single-org Salesforce MCP server built on jsforce. Bring-your-own OAuth token — no credentials stored server-side. Runs over stdio (Claude Code) or as a dedicated streamable-HTTP server.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.8","jsforce":"^3.6.3","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.0","typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/salesforce-mcp-jsforce_0.3.0_1781851889688_0.9690544117674362","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@imazhar101/salesforce-mcp-jsforce","version":"0.4.1","keywords":["mcp","model-context-protocol","salesforce","jsforce","claude","oauth"],"author":{"name":"imazhar101"},"license":"MIT","_id":"@imazhar101/salesforce-mcp-jsforce@0.4.1","maintainers":[{"name":"imazhar101","email":"imazhar101@gmail.com"}],"homepage":"https://github.com/imazhar101/salesforce-mcp-jsforce#readme","bugs":{"url":"https://github.com/imazhar101/salesforce-mcp-jsforce/issues"},"bin":{"salesforce-mcp-jsforce":"dist/index.js"},"dist":{"shasum":"c1ab7e9f26b0645480777efe5c65f80e95e47eab","tarball":"https://registry.npmjs.org/@imazhar101/salesforce-mcp-jsforce/-/salesforce-mcp-jsforce-0.4.1.tgz","fileCount":27,"integrity":"sha512-GB1GJEnkCThLvgSOgvT5pWmPXkfZIfNueRAn1EWSTTY86FFGxEtNT2/PCiyf98TTO5IJCBSom8Ry1Dn4w68Ypw==","signatures":[{"sig":"MEYCIQCeonetcGInBiOxtfaKzKBQxiO5+/myAede4KxxYIYL3wIhAMksTB+k1Pgplv2H5KFNWSQrlNeYjmDdjAcz7I0rwpCY","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@imazhar101%2fsalesforce-mcp-jsforce@0.4.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":103211},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"743de49001ffa62c81231122f60b044d344a1aef","scripts":{"dev":"tsx src/index.ts","http":"tsx src/index.ts http","test":"tsx --test tests/*.test.ts","build":"tsc","login":"tsx src/index.ts login","format":"prettier --write .","format:check":"prettier --check .","prepublishOnly":"npm run build"},"_npmUser":{"name":"imazhar101","email":"imazhar101@gmail.com"},"repository":{"url":"git+https://github.com/imazhar101/salesforce-mcp-jsforce.git","type":"git"},"_npmVersion":"10.8.2","description":"A lite, single-org Salesforce MCP server built on jsforce. Bring-your-own OAuth token — no credentials stored server-side. Runs over stdio (Claude Code) or as a dedicated streamable-HTTP server.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.8","jsforce":"^3.6.3","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.12","prettier":"^3.9.6","typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/salesforce-mcp-jsforce_0.4.1_1786492412435_0.07297726479174882","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"@imazhar101/salesforce-mcp-jsforce","version":"0.4.2","keywords":["mcp","model-context-protocol","salesforce","jsforce","claude","oauth"],"author":{"name":"imazhar101"},"license":"MIT","_id":"@imazhar101/salesforce-mcp-jsforce@0.4.2","maintainers":[{"name":"imazhar101","email":"imazhar101@gmail.com"}],"homepage":"https://github.com/imazhar101/salesforce-mcp-jsforce#readme","bugs":{"url":"https://github.com/imazhar101/salesforce-mcp-jsforce/issues"},"bin":{"salesforce-mcp-jsforce":"dist/index.js"},"dist":{"shasum":"0d6f3bfae589f39e9cc9e2bb28aabb881bb9b75d","tarball":"https://registry.npmjs.org/@imazhar101/salesforce-mcp-jsforce/-/salesforce-mcp-jsforce-0.4.2.tgz","fileCount":27,"integrity":"sha512-l/XfBWn8XvoYNsL1YyZYjpfg2R6t9HrQW0/ewGyFSBHopj7mV3mogn8osuRzoFcko2gViYYRWkrTC1J6KXZjoA==","signatures":[{"sig":"MEYCIQCdKds9cONYebxlkKB1aXCxC+AC+QRvti7ji5XNRDL5oQIhAMbgFgD32YOeqBicROmz8b+Fz0aS7KiF3X6JE9OK1vz7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@imazhar101%2fsalesforce-mcp-jsforce@0.4.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":104731},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"b4844d61c0e4989069f0d19167e2f28ac6dff9e3","scripts":{"dev":"tsx src/index.ts","http":"tsx src/index.ts http","test":"tsx --test tests/*.test.ts","build":"tsc","login":"tsx src/index.ts login","format":"prettier --write .","format:check":"prettier --check .","prepublishOnly":"npm run build"},"_npmUser":{"name":"imazhar101","email":"imazhar101@gmail.com"},"repository":{"url":"git+https://github.com/imazhar101/salesforce-mcp-jsforce.git","type":"git"},"_npmVersion":"10.8.2","description":"A lite, single-org Salesforce MCP server built on jsforce. Bring-your-own OAuth token — no credentials stored server-side. Runs over stdio (Claude Code) or as a dedicated streamable-HTTP server.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.8","jsforce":"^3.6.3","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.12","prettier":"^3.9.6","typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/salesforce-mcp-jsforce_0.4.2_1786492792085_0.09862586408359308","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@imazhar101/salesforce-mcp-jsforce","version":"0.5.0","keywords":["mcp","model-context-protocol","salesforce","jsforce","claude","oauth"],"author":{"name":"imazhar101"},"license":"MIT","_id":"@imazhar101/salesforce-mcp-jsforce@0.5.0","maintainers":[{"name":"imazhar101","email":"imazhar101@gmail.com"}],"homepage":"https://github.com/imazhar101/salesforce-mcp-jsforce#readme","bugs":{"url":"https://github.com/imazhar101/salesforce-mcp-jsforce/issues"},"bin":{"salesforce-mcp-jsforce":"dist/index.js"},"dist":{"shasum":"aa1779d44ec0ce83fa2327de06eb1c7938f0d20a","tarball":"https://registry.npmjs.org/@imazhar101/salesforce-mcp-jsforce/-/salesforce-mcp-jsforce-0.5.0.tgz","fileCount":36,"integrity":"sha512-SCjzOp39qAMUzxNmtYEKvu6SumMNr5QcBZhbCQUcSUZyz9J1f/G+wxDZFpkLWd4JhnAryfC/G5EfFLCMPjckKQ==","signatures":[{"sig":"MEUCIHU1/i1bUXns/xymE9U8XFhItfA1IkNwl7p2EJSmCg27AiEAsYc1tLofLbvQH3OZeBfcglHn+NYpxIOO/8YRV4OM5Bs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@imazhar101%2fsalesforce-mcp-jsforce@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":150634},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"6cfb457ac1772f926bfc9697473589aaef8eabfb","scripts":{"dev":"tsx src/index.ts","http":"tsx src/index.ts http","test":"tsx --test tests/*.test.ts","build":"tsc","login":"tsx src/index.ts login","format":"prettier --write .","format:check":"prettier --check .","prepublishOnly":"npm run build"},"_npmUser":{"name":"imazhar101","email":"imazhar101@gmail.com"},"repository":{"url":"git+https://github.com/imazhar101/salesforce-mcp-jsforce.git","type":"git"},"_npmVersion":"10.8.2","description":"A lite, single-org Salesforce MCP server built on jsforce. Bring-your-own OAuth token — no credentials stored server-side. Runs over stdio (Claude Code) or as a dedicated streamable-HTTP server.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.8","jsforce":"^3.6.3","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.12","prettier":"^3.9.6","typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/salesforce-mcp-jsforce_0.5.0_1786739345310_0.41830394757078304","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@imazhar101/salesforce-mcp-jsforce","version":"0.5.1","keywords":["mcp","model-context-protocol","salesforce","jsforce","claude","oauth"],"author":{"name":"imazhar101"},"license":"MIT","_id":"@imazhar101/salesforce-mcp-jsforce@0.5.1","maintainers":[{"name":"imazhar101","email":"imazhar101@gmail.com"}],"homepage":"https://github.com/imazhar101/salesforce-mcp-jsforce#readme","bugs":{"url":"https://github.com/imazhar101/salesforce-mcp-jsforce/issues"},"bin":{"salesforce-mcp-jsforce":"dist/index.js"},"dist":{"shasum":"8f39dae7e186270e360d6706f063a3fc575cc112","tarball":"https://registry.npmjs.org/@imazhar101/salesforce-mcp-jsforce/-/salesforce-mcp-jsforce-0.5.1.tgz","fileCount":36,"integrity":"sha512-Bm6eh9G8DogbvaKnVTaSE8c4RADlp0IBtDJGIRXe2y+V7Kq43A+vMS4BldggjuLtaAfaGZnaCqoJVzNyyzyeGg==","signatures":[{"sig":"MEQCIAH4gPWnlxLsMcZBGSCzcrh6AC8AR82Im+UvmcQZL1pXAiBgDh1Yd4l86mwake/dPzY2Tt6Bvl5N+Z65WnPJBsfyYQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@imazhar101%2fsalesforce-mcp-jsforce@0.5.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":153436},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"8e70790ecec9c695fc65ab1338355b9d82c252a8","scripts":{"dev":"tsx src/index.ts","http":"tsx src/index.ts http","test":"tsx --test tests/*.test.ts","build":"tsc","login":"tsx src/index.ts login","format":"prettier --write .","format:check":"prettier --check .","prepublishOnly":"npm run build"},"_npmUser":{"name":"imazhar101","email":"imazhar101@gmail.com"},"repository":{"url":"git+https://github.com/imazhar101/salesforce-mcp-jsforce.git","type":"git"},"_npmVersion":"10.8.2","description":"A lite, single-org Salesforce MCP server built on jsforce. Bring-your-own OAuth token — no credentials stored server-side. Runs over stdio (Claude Code) or as a dedicated streamable-HTTP server.","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.23.8","jsforce":"^3.6.3","@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.12","prettier":"^3.9.6","typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/salesforce-mcp-jsforce_0.5.1_1786740299009_0.6467765013423852","host":"s3://npm-registry-packages-npm-production"}},"0.5.2":{"name":"@imazhar101/salesforce-mcp-jsforce","version":"0.5.2","description":"A lite, single-org Salesforce MCP server built on jsforce. Bring-your-own OAuth token — no credentials stored server-side. Runs over stdio (Claude Code) or as a dedicated streamable-HTTP server.","type":"module","license":"MIT","author":{"name":"imazhar101"},"repository":{"type":"git","url":"git+https://github.com/imazhar101/salesforce-mcp-jsforce.git"},"homepage":"https://github.com/imazhar101/salesforce-mcp-jsforce#readme","bugs":{"url":"https://github.com/imazhar101/salesforce-mcp-jsforce/issues"},"keywords":["mcp","model-context-protocol","salesforce","jsforce","claude","oauth"],"main":"dist/index.js","bin":{"salesforce-mcp-jsforce":"dist/index.js"},"engines":{"node":">=18"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","login":"tsx src/index.ts login","http":"tsx src/index.ts http","prepublishOnly":"npm run build","format":"prettier --write .","format:check":"prettier --check .","test":"tsx --test tests/*.test.ts"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","jsforce":"^3.6.3","zod":"^3.23.8"},"devDependencies":{"@types/node":"^20.14.0","prettier":"^3.9.6","tsx":"^4.23.12","typescript":"^5.5.0"},"_id":"@imazhar101/salesforce-mcp-jsforce@0.5.2","gitHead":"a560b2dc2ac5796ab4f98c6b0bad232c5443b1e6","types":"./dist/index.d.ts","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-1mJDY7IsLsbd4EmRuYSQKAY5DRVm17TxlzeIPKoUWq5q9VwGwmML6w0AKKsQdBrRQJfwGF8zZR08qIe7WR3lDw==","shasum":"13b520e3ed8e3ed772a805a7d8c5ef781dc4f1a1","tarball":"https://registry.npmjs.org/@imazhar101/salesforce-mcp-jsforce/-/salesforce-mcp-jsforce-0.5.2.tgz","fileCount":36,"unpackedSize":156873,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@imazhar101%2fsalesforce-mcp-jsforce@0.5.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCHcBAgwFXZZMm9mNKZSSSJUx9ZRw0eEJMj5E3fMcAI4QIhAKY6tOXdJYcJ57SKuim8e2DpqGS6szaocQ0OFA+rPP1c"}]},"_npmUser":{"name":"imazhar101","email":"imazhar101@gmail.com"},"directories":{},"maintainers":[{"name":"imazhar101","email":"imazhar101@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/salesforce-mcp-jsforce_0.5.2_1787095307614_0.1682369818044025"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-19T05:31:11.108Z","modified":"2026-08-18T23:21:48.126Z","0.1.0":"2026-06-19T05:31:11.496Z","0.2.0":"2026-06-19T06:33:03.893Z","0.3.0":"2026-06-19T06:51:29.843Z","0.4.1":"2026-08-11T23:53:32.590Z","0.4.2":"2026-08-11T23:59:52.225Z","0.5.0":"2026-08-14T20:29:05.451Z","0.5.1":"2026-08-14T20:44:59.149Z","0.5.2":"2026-08-18T23:21:47.794Z"},"bugs":{"url":"https://github.com/imazhar101/salesforce-mcp-jsforce/issues"},"author":{"name":"imazhar101"},"license":"MIT","homepage":"https://github.com/imazhar101/salesforce-mcp-jsforce#readme","keywords":["mcp","model-context-protocol","salesforce","jsforce","claude","oauth"],"repository":{"type":"git","url":"git+https://github.com/imazhar101/salesforce-mcp-jsforce.git"},"description":"A lite, single-org Salesforce MCP server built on jsforce. Bring-your-own OAuth token — no credentials stored server-side. Runs over stdio (Claude Code) or as a dedicated streamable-HTTP server.","maintainers":[{"name":"imazhar101","email":"imazhar101@gmail.com"}],"readme":"# salesforce-mcp-jsforce\n\nA **lite, single-org** [Model Context Protocol](https://modelcontextprotocol.io) server for Salesforce, built on [jsforce](https://github.com/jsforce/jsforce).\n\n- **Bring your own token.** The server never stores a username or password. You authenticate once with OAuth; it holds an access token + instance URL (plus, for stdio, a refresh token).\n- **Sign in once.** An expired access token is renewed from the saved refresh token and the failed call retried, so a long-running client keeps working until the grant is revoked.\n- **Two ways to run.** Locally over **stdio** (for Claude Code and other MCP clients) or as a **dedicated streamable-HTTP server** where each request carries its own token.\n- **Safe to host & open-source.** No org-specific config, no multi-environment credential matrix, no destructive metadata tooling. Optional read-only mode.\n\n## Tools\n\n| Tool                         | Mode  | Description                                           |\n| ---------------------------- | ----- | ----------------------------------------------------- |\n| `salesforce_identity`        | read  | Identity of the supplied token (token validity check) |\n| `salesforce_query`           | read  | Run a SOQL query                                      |\n| `salesforce_search`          | read  | Run a SOSL full-text search                           |\n| `salesforce_list_objects`    | read  | List sObjects + key metadata                          |\n| `salesforce_describe_object` | read  | Trimmed describe of an sObject                        |\n| `salesforce_get_record`      | read  | Retrieve a record by Id                               |\n| `salesforce_create_record`   | write | Create a record                                       |\n| `salesforce_update_record`   | write | Update a record                                       |\n| `salesforce_delete_record`   | write | Delete a record                                       |\n\nSet `SF_READONLY=1` to register the read tools only.\n\n## Quick start\n\n```bash\nnpm install -g @imazhar101/salesforce-mcp-jsforce\n\n# 1. Log in (PKCE against your External Client App)\nsalesforce-mcp-jsforce login --client-id <ECA_CONSUMER_KEY>\n#   sandbox: add --login-url https://test.salesforce.com\n\n# 2. Use it from Claude Code\nclaude mcp add salesforce -- npx -y @imazhar101/salesforce-mcp-jsforce\n```\n\n`login` opens a browser, completes the OAuth handshake, saves the token to\n`~/.config/salesforce-mcp-jsforce/token.json`, and prints ready-to-paste config.\nSign out (and revoke the grant at Salesforce) with `salesforce-mcp-jsforce logout`.\n\n## Credentials\n\n**stdio** — one of:\n\n- the token file written by `login` (read automatically, **renewed automatically**), or\n- `SF_ACCESS_TOKEN` + `SF_INSTANCE_URL` environment variables.\n\nEnv credentials win when both are present. They carry no refresh token, so they\ncannot be renewed — prefer the token file unless something else is minting\nshort-lived tokens for you.\n\n### Token renewal\n\nSalesforce access tokens expire on the org's session policy, typically hours.\nWhen a call fails with `INVALID_SESSION_ID`, the server runs the `refresh_token`\ngrant, writes the new token back to the token file (atomically, `0600`) and\nretries the call once. Concurrent calls share a single refresh. Nothing is\nretried a second time — if a freshly issued token is also rejected, the problem\nis not token age.\n\nRenewal needs `refreshToken`, `clientId` and `loginUrl` in the token file, which\n`login` saves when the `refresh_token` scope is granted. HTTP callers and\ngateway `_sfAuth` callers are passed through untouched: those tokens belong to\nwhoever minted them.\n\n**HTTP** — per request, via headers:\n\n- `X-SF-Access-Token`\n- `X-SF-Instance-Url`\n- `X-SF-Api-Version` (optional)\n\n## Run as a dedicated HTTP server\n\n```bash\nPORT=3000 salesforce-mcp-jsforce http\n```\n\nStateless streamable-HTTP at `POST /mcp`; health probe at `GET /health`. Each\nrequest is handled by a throwaway server instance keyed to its own token — no\ncaller state is shared. Put it behind TLS; the access token is a live credential.\n\nIt binds **`127.0.0.1`** by default and rejects requests whose `Host`/`Origin`\nis not loopback, which is what stops a page in your browser from reaching it by\nDNS rebinding. To expose it, set `SF_MCP_HOST=0.0.0.0` **and**\n`SF_MCP_ALLOWED_HOSTS=your.host` — deliberately, and behind a proxy that\nauthenticates, because this server authenticates nobody: it forwards whatever\ntoken the request carries.\n\n```bash\ncurl -s http://localhost:3000/mcp \\\n  -H 'content-type: application/json' \\\n  -H 'accept: application/json, text/event-stream' \\\n  -H \"X-SF-Access-Token: $SF_ACCESS_TOKEN\" \\\n  -H \"X-SF-Instance-Url: $SF_INSTANCE_URL\" \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n```\n\n## Relay mode — route calls through an MCP gateway\n\nBy default this server talks straight to Salesforce. If it runs behind an MCP\ngateway that is supposed to govern data access, that traffic is invisible to it:\nno activity log, no scope enforcement, and read-only enforced only by a\nclient-side env var the user can remove.\n\nRelay mode fixes that without moving credentials off the machine. Set\n`SF_RELAY_URL` and the server stops calling Salesforce itself — it forwards each\nJSON-RPC request to the gateway, which runs the real server and applies its own\npolicy:\n\n```bash\nexport SF_RELAY_URL=https://conduit.example.com/mcp/le-salesforce\nsalesforce-mcp-jsforce login            # Salesforce — which data you may see\nsalesforce-mcp-jsforce login --gateway  # gateway — who you are, for scopes + audit\n```\n\nTwo independent credentials ride on every relayed request, each refreshing\nitself:\n\n| Header                                    | Carries                                        | Refreshed by            |\n| ----------------------------------------- | ---------------------------------------------- | ----------------------- |\n| `Authorization: Bearer …`                 | gateway identity, for scope checks and logging | `login --gateway` grant |\n| `X-SF-Access-Token` / `X-SF-Instance-Url` | Salesforce authorization                       | `login` grant           |\n\nThe gateway stores **no** Salesforce credentials — it reads the `X-SF-*` headers\ninto a per-request injection and strips them before writing its activity log.\nYour Salesforce refresh token stays on your machine, exactly as in direct mode.\n\nThe relay does not interpret the protocol: it forwards requests verbatim and\nreturns the gateway's reply unchanged, so it cannot drift out of sync with\nwhatever tools the gateway's copy of the server exposes. Each credential gets\nexactly one retry, and only for the failure it can fix — a `401` renews the\ngateway token, an expired-session payload renews the Salesforce one.\n\nScope denials are passed through untouched: the gateway answers `200` with a\nJSON-RPC error so the client shows the reason rather than hanging, and that\nmessage (`Access denied: Missing required scope: …`) is already the clearest\nthing to show. A bare `403`, which means something in front of the gateway\nrejected the call, is surfaced with its status.\n\nThe MCP handshake (`initialize`, `ping`) is answered locally and never reaches\nthe gateway, so the server still connects when you are not signed in — the auth\nerror appears on the first real call, where your client can show it, instead of\nthe whole server failing with an unreadable code.\n\nSign out of the gateway alone with `salesforce-mcp-jsforce logout --gateway`\n(this drops the local gateway token; it does not touch the Salesforce grant).\n\n## Environment variables\n\n### Credentials and tools\n\n| Var               | Default | Purpose                                                   |\n| ----------------- | ------- | --------------------------------------------------------- |\n| `SF_ACCESS_TOKEN` | —       | stdio access token — wins over the token file, no renewal |\n| `SF_INSTANCE_URL` | —       | stdio instance URL                                        |\n| `SF_API_VERSION`  | `62.0`  | REST API version                                          |\n| `SF_READONLY`     | off     | `1` strips write tools                                    |\n\n### `login`\n\n| Var / flag                             | Default                            | Purpose                                                    |\n| -------------------------------------- | ---------------------------------- | ---------------------------------------------------------- |\n| `SF_CLIENT_ID` / `--client-id`         | —                                  | ECA consumer key (required)                                |\n| `SF_LOGIN_URL` / `--login-url`         | `https://login.salesforce.com`     | OAuth host; must be https (sandbox: `test.salesforce.com`) |\n| `SF_SCOPE` / `--scope`                 | `api refresh_token`                | OAuth scopes — drop `refresh_token` and renewal stops      |\n| `SF_CALLBACK_PORT` / `--port`          | `1717`                             | Loopback callback port                                     |\n| `SF_REDIRECT_URI` / `--redirect-uri`   | `http://localhost:<port>/callback` | Full callback URL; loopback hosts only                     |\n| `SF_CLIENT_SECRET` / `--client-secret` | —                                  | Confidential clients only; public PKCE apps omit it        |\n| `SF_LOGIN_TIMEOUT_MS`                  | `300000`                           | How long to wait for the browser round trip                |\n\nThe callback port and redirect URI must match what the Connected App registers.\nSalesforce compares `redirect_uri` byte-for-byte, so a different port — or\n`127.0.0.1` where the app registered `localhost` — fails the flow with\n`redirect_uri_mismatch` before the sign-in screen appears.\n\n### Server\n\n| Var                     | Default                            | Purpose                                              |\n| ----------------------- | ---------------------------------- | ---------------------------------------------------- |\n| `SF_MCP_CONFIG_DIR`     | `~/.config/salesforce-mcp-jsforce` | Token storage location                               |\n| `SF_MCP_HOST`           | `127.0.0.1`                        | HTTP bind address                                    |\n| `SF_MCP_ALLOWED_HOSTS`  | —                                  | Extra `Host`/`Origin` values the HTTP server accepts |\n| `SF_MCP_MAX_BODY_BYTES` | `1048576`                          | Request body ceiling                                 |\n| `PORT`                  | `3000`                             | HTTP listen port                                     |\n\n## Security model\n\n- The token grants exactly the permissions of the user who authorized it — the server adds no privilege.\n- In HTTP mode no credentials are persisted; the token lives only for the duration of one request.\n- The stdio token file is written `0600` inside a `0700` directory, replaced atomically via a temp file + rename.\n- Tokens are never logged and never printed by `login`. Errors returned to the model are redacted (session ids, bearer/refresh tokens, OAuth form fields).\n- OAuth login is PKCE with a `state` check, requires an **https** login URL, and times out rather than waiting forever. The callback listens on the loopback interface only — both `127.0.0.1` and `::1`, since `localhost` resolves to either depending on the machine — and a busy port is a hard error, never a silent fallback that would let another process receive the authorization code. `--redirect-uri` is restricted to loopback hosts.\n- The browser is launched via `spawn` with argv — never a shell string, so nothing in the URL reaches a shell.\n- The HTTP listener is loopback-only by default, validates `Host`/`Origin`, and caps request bodies.\n- `logout` revokes the grant at Salesforce, not just locally.\n- Relay mode requires an **https** gateway URL (loopback excepted, for local gateways), so the bearer token is never sent in the clear. The gateway token file gets the same `0600`/`0700` atomic write as the Salesforce one, and gateway errors are redacted before they reach the model — a gateway that echoes the request back cannot leak the Salesforce token into the transcript.\n\n**Known limitation:** the refresh token is stored as plaintext JSON (`0600` in a\n`0700` directory). That stops other local users, but not code running as you —\nany process in your account can read it. An OS-keychain backend is tracked in\n[#13](https://github.com/imazhar101/salesforce-mcp-jsforce/issues/13). Treat the\ntoken file as a live credential, and run `logout` on a machine you are handing\noff.\n\n## Build from source\n\n```bash\nnpm install\nnpm run build\nnode dist/index.js --help\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}