Contentful Delivery MCP Server

Contentful MCP Server for Delivery API

Local serverstdioTypeScript

What is the Contentful Delivery MCP server?

Contentful Delivery MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Contentful MCP Server for Delivery API.

What you get

A Model Context Protocol (MCP) server that provides seamless access to Contentful's Delivery API through AI assistants. Query and retrieve content entries, assets, and content types using natural language.

  • Natural language queries to search content
  • Retrieve entries by ID or content type
  • Asset management
  • Content type schema access
  • Pagination support
  • Rich text content handling

What the assistant can call

Once Contentful Delivery is connected, these are the calls the assistant has available:

  • query_entries — Natural language search across all content
  • get_entry — Fetch specific entry by ID
  • get_entries — List entries with filtering
  • get_assets — Browse all assets
  • get_asset — Get asset details by ID
  • get_content_type — View content type schema
  • get_content_types — List available content types

Configuration and credentials

You will need 3 environment variables: CONTENTFUL_SPACE_ID, CONTENTFUL_ACCESS_TOKEN, CONTENTFUL_CONTENT_TYPE_IDS. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Setting it up

Installation goes through your MCP client rather than a global install: point it at @mshaaban0/contentful-delivery-mcp-server on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Choosing this one

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Contentful Delivery's toolset — query_entries, get_entry, get_entries and 4 more — is a fair guide to whether it matches your workflow. It is maintained by mshaaban0; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Contentful Delivery's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the contentful delivery mcp server does with a few real requests.

Available tools

ToolWhat it does
query_entriesNatural language search across all content
get_entryFetch specific entry by ID
get_entriesList entries with filtering
get_assetsBrowse all assets
get_assetGet asset details by ID
get_content_typeView content type schema
get_content_typesList available content types

How to install the Contentful Delivery MCP server

{
  "mcpServers": {
    "contentful-delivery": {
      "command": "npx",
      "args": ["-y", "@mshaaban0/contentful-delivery-mcp-server"],
      "env": {
        "CONTENTFUL_SPACE_ID": "your-value",
        "CONTENTFUL_ACCESS_TOKEN": "your-value",
        "CONTENTFUL_CONTENT_TYPE_IDS": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
CONTENTFUL_SPACE_IDConfiguration value read at startup.Optional
CONTENTFUL_ACCESS_TOKENCredential the server authenticates with.Yes
CONTENTFUL_CONTENT_TYPE_IDSConfiguration value read at startup.Optional

Example prompts to try

  • Use Contentful Delivery to query entries.
  • Use Contentful Delivery to get entry.
  • Use Contentful Delivery to get entries.

Frequently asked questions

Node.js and npm are required. You also need a Contentful account with a Space ID and a Delivery Access Token.