Use Noma inside Cursor

Create an API key under User settings → API keys and copy your Project ID from the project home or Project settings → API access. Match key abilities to what you plan to do (read-only browsing vs creating entries or editing schema). See the Noma MCP server page for the ability matrix.

Cursor connects to MCP over stdio, HTTP, or SSE. Noma ships a stdio server via npm, which matches Cursor’s documented command / args / env pattern. See Cursor’s guide: Model Context Protocol (MCP).

You can commit .cursor/mcp.json in a repo for team-wide setup, or use ~/.cursor/mcp.json for a personal default. Cursor supports ${env:NAME} interpolation so secrets stay out of git.

Add a server entry that runs npx -y @nomacms/mcp-server with NOMA_API_KEY and NOMA_PROJECT_ID:

{
  "mcpServers": {
    "nomacms": {
      "command": "npx",
      "args": ["-y", "@nomacms/mcp-server"],
      "env": {
        "NOMA_API_KEY": "your-api-key",
        "NOMA_PROJECT_ID": "your-project-uuid"
      }
    }
  }
}

Restart Cursor or toggle the server in Settings → Tools & MCPs. If tools do not appear, open the MCP output log and confirm the process starts without env errors.

For deeper SDK and framework guardrails, install skills from the open-source Noma agent skills repo using the skills CLI. Example:

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

If you use MCP to evolve schema before UI work, add noma-mcp-content-structure so the agent keeps pages data-driven rather than hard-coded. Details on Skills.

• List collections — “List my Noma collections and summarize each one’s purpose from the slug and fields.”
• Schema + content — “Show the field schema for collection blog_posts, then list the five most recently updated entries.”
• Safe writes — “Draft a new entry for faq with title and body; show the tool args before running create_entry.”
• App integration — “Given this collection schema, generate a typed fetch helper using @nomacms/js-sdk.”

• Noma MCP server on GitHub
• MCP in the Noma product overview