$ norc-mcp
Check and fix your cron jobs from an AI chat.
Checking on a job usually means logging into a machine. norc-mcp is an MCP server that connects Claude, ChatGPT and other AI chat clients to your norc account. Ask which jobs exist, check run history or change a schedule.
Thin and stateless: it holds no secrets of its own. MIT licensed.
Connect norc-mcp
Generate a norc API key (vault → Settings → API Keys → Generate key), then pick a channel. Remote clients use the hosted URL with the key as the Bearer token; the commands below read it from NORC_API_KEY. Claude Desktop and the Claude Code plugin run norc-mcp locally over stdio instead.
One click adds the hosted server. VS Code asks for your API key once and stores it as a secret. Cursor reads NORC_API_KEY from your environment, or paste the key into the Authorization header in Cursor's MCP settings.
| Channel | Platform | Command / URL |
|---|---|---|
| hosted | Any MCP client | https://mcp.norc.app/mcp |
| Claude Code | Claude Code | claude mcp add --scope user --transport http norc https://mcp.norc.app/mcp --header 'Authorization: Bearer ${NORC_API_KEY}' |
| Codex CLI | OpenAI Codex | codex mcp add norc --url https://mcp.norc.app/mcp --bearer-token-env-var NORC_API_KEY |
| Gemini CLI | Gemini CLI | gemini mcp add -s user -t http norc https://mcp.norc.app/mcp -H 'Authorization: Bearer ${NORC_API_KEY}' |
| Claude Desktop | Claude Desktop | Settings, Developer, Edit Config, then add to mcpServers: "norc": { "command": "npx", "args": ["-y", "norc-mcp"], "env": { "NORC_API_KEY": "norc_sk_..." } }. Needs Node 20+. On Windows, if npx fails to launch, use "command": "cmd" with "args": ["/c", "npx", "-y", "norc-mcp"]. Quit and reopen Claude Desktop. details |
| Claude Code plugin | Claude Code | claude plugin marketplace add norcapp/norc-claude-plugin && claude plugin install norc details |
| self-host | Node 20+ | pnpm install && pnpm build && node dist/server.js |
A self-hosted norc-mcp still talks to the hosted vault API (or your own $NORC_VAULT_URL).
Ask a question. See the result.
norc-mcp passes your API key to the vault, and the vault's answer comes back into the chat.
What it can do
Four for jobs, three for machines, one for run history, one for GitOps sync.
Jobs
list_jobs, create_job, update_job, delete_job: read and edit your cron jobs from the conversation.
Machines
list_machines, rename_machine, delete_machine: see and manage every paired machine on your account.
Runs
list_runs: check when jobs ran and what they returned, without leaving the chat. Useful when you suspect a job never ran.
GitOps
sync_jobs: preview and apply a complete desired job set. Defaults to a dry run; with apply=true, jobs missing from the set are deleted. Requires the GitOps sync feature on your account.
Open source
MIT licensed and public. Audit it, self-host it or run it locally with npx. The rest of norc is closed source.
One API key lets your AI chat check and change your norc jobs.