Use Noma with Claude Code

Claude Code can run the same stdio MCP server as other agents. Register Noma once per machine or project, then let Claude list collections, query entries, and perform allowed writes with your API key.

Documentation: Get started with AI code editors

Before you start

Prerequisites

You need a Noma API key and Project ID. Create the key under User settings → API keys; copy the project id from the dashboard or Project settings → API access. Restrict abilities to the minimum you need—see MCP server abilities.

Official docs

MCP in Claude Code

Claude Code manages MCP servers through its CLI and project configuration. For the latest options (including OAuth and project-scoped config), start from Anthropic’s docs: Claude Code MCP.

Install

Add the Noma MCP server

From a terminal with Claude Code available, register the stdio server and pass Noma credentials as environment variables:

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

This matches the maintained snippet in the MCP server README. If your team stores MCP definitions in JSON under .claude, mirror the same command, args, and env fields there.

Agent skills

Noma skill packs

Install curated markdown skills so Claude reaches for SDK patterns, auth contracts, and framework notes automatically:

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

Browse all packages in the agent skills repository. More on installation on the Skills page.

Examples

Prompts that work well

Explore structure — “Call list_collections, then get_collection for the marketing singleton.”
Content QA — “Find entries in docs missing a hero image using list_entries filters.”
Localization — “Show the default locale, then fetch matching entries across en and de.”
Automation — “Propose a webhook for publish events to our preview URL; list required fields before create_webhook.”

Reference