Use Noma with Codex

Provision NOMA_API_KEY and NOMA_PROJECT_ID from the Noma dashboard. Prefer scoped keys: read-only for exploration, broader abilities only when you expect Codex to create or mutate content. See abilities reference.

Codex documents MCP servers in ~/.codex/config.toml with optional project overrides in .codex/config.toml for trusted repositories. You can also use codex mcp add to generate entries. Full detail: Model Context Protocol – Codex.

Equivalent to other agents: stdio via npx.

codex mcp add nomacms \
  --env NOMA_API_KEY=your-api-key \
  --env NOMA_PROJECT_ID=your-project-uuid \
  -- npx -y @nomacms/mcp-server

Verify with codex mcp list and inspect a single entry using codex mcp get nomacms if needed.

To check in team defaults, add a block under [mcp_servers.nomacms] (names can vary) following Codex’s documented shape:

[mcp_servers.nomacms]
command = "npx"
args = ["-y", "@nomacms/mcp-server"]

[mcp_servers.nomacms.env]
NOMA_API_KEY = "your-api-key"
NOMA_PROJECT_ID = "your-project-uuid"

Keep secrets in environment variables or your password manager—Codex supports forwarding allowed env vars without hardcoding tokens in repo files.

Codex benefits from the same markdown skills as other hosts. Install packs with npx skills add:

npx skills add nomacms/nomacms-agent-skills --skill noma-sdk-setup --skill noma-content

Repository: nomacms agent skills. Package name on npm: @nomacms/mcp-server.

• Plan then act — “Plan how to add a boolean featured field; then call the MCP tools in order with my approval.”
• Bulk operations — “Use bulk create to seed ten placeholder FAQ entries from this table.”
• Assets — “List recent assets, then attach the right hero UUID to the homepage entry.”
• Resources — “Read nomacms://query-reference and build a filter for stale entries.”

• Noma MCP server README
• Other AI coding agents