Quickstart¶
Get the server running against a Drupal site and make your first tool call.
1. Install¶
Or with uv:
2. Configure¶
Copy the example environment file:
The only required values are the site URL and a credential pair:
The server logs in to /user/login and reuses the session cookie plus the CSRF
token that Drupal's mutating JSON:API endpoints require — basic auth alone is
rejected with 403 on writes. If you're pointing at a local DDEV or Lando site
with a self-signed certificate, also set:
See Configuration for OAuth, bearer-token, Drush, AI provider, and transport options.
3. Run¶
Start the server over stdio (the default, used by desktop MCP clients):
To confirm it is alive, send a tools/list request:
4. Connect an MCP client¶
For Claude Desktop, add the server to
~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"drupal": {
"command": "drupal-mcp",
"env": {
"DRUPAL_BASE_URL": "https://your-drupal-site.com",
"DRUPAL_USERNAME": "admin",
"DRUPAL_PASSWORD": "secret"
}
}
}
}
Restart Claude Desktop; the Drupal tools appear in the tool picker.
Next steps¶
- AI Coding Agents — register with Claude Code, Cursor, Codex, OpenCode and more via
drupal-mcp install - Configuration — authentication, Drush, AI providers, transport
- Tools — the full tool catalog by category
- Migration — end-to-end content migration between Drupal sites