How to connect Nextdns to Claude

Connect Claude Web, Desktop and Cowork to Nextdns MCP. Block access to adult websites for a profile, download dns logs from last week, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Nextdns

Api Key

NextDNS is a DNS service that blocks malicious sites, ads, and trackers before they reach your device. It boosts your internet security and privacy with real-time protection and granular control.

68 Tools

Managed auth

Connect Nextdns without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Nextdns account to Claude via Composio Connect, enabling it to block access to adult websites for a profile, download DNS logs from last week, show top domains queried by your devices, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Nextdns with

Claude Code OpenAI Agents SDK Claude Agent SDK Codex OpenClaw Hermes Atomic Agent Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI Pydantic AI AutoGen

Connecting Nextdns to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash

https://connect.composio.dev/mcp

Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Nextdns account

Back in Claude, ask it to connect to Nextdns or give it any Nextdns-related task.

For example, ask Claude to:

"Block access to adult websites for a profile"
"Download DNS logs from last week"
"Show top domains queried by your devices"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Nextdns account is ready to use.

What is the Nextdns Claude Connector, and what's possible with it?

The Nextdns MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Nextdns account. It provides structured and secure access to your DNS security and privacy controls, so your agent can perform actions like blocking domains, managing profiles, analyzing DNS analytics, and clearing logs on your behalf.

Dynamic domain and TLD blocking: Instantly add domains or top-level domains to your denylist or security blocklist, helping you stay ahead of new threats.
Profile management and configuration: Create, update, or delete NextDNS configuration profiles to tailor DNS filtering and security settings for different users or devices.
Comprehensive DNS analytics: Retrieve detailed analytics by device, domain, or client IP to monitor DNS activity, spot anomalies, and optimize security policies.
Log management and export: Download DNS query logs for audit or troubleshooting, or clear logs entirely to maintain your privacy.
Control over block page settings: Enable or disable the block page for any configuration, giving you flexibility over how blocks are displayed to users.

Troubleshooting

1. Why does Claude not use the Composio connector for Nextdns?

The connector can show as connected, but Claude must use it in each Nextdns conversation.

Click + at the lower left of the chat, or type /.
Hover Connectors.
Turn on Composio.
Ask Claude to connect to Nextdns again.

2. Why does Claude show an MCP server error before Nextdns connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Nextdns.

Check that the connector URL is https://connect.composio.dev/mcp.
Connectors run from Anthropic's cloud, so your device network is usually not the problem.
Add the connector again from Customize > Connectors, then ask Claude to connect Nextdns.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Nextdns authorization link not work?

The Composio connector is one server. Your Nextdns account connects separately when Claude asks for it.

If the browser does not open, or the link expires, ask Claude to retry the Nextdns connection.
Composio creates a fresh Nextdns authorization link.
Open that link in your browser and finish the Nextdns sign-in.

4. Why do Nextdns actions fail after they worked before?

The Nextdns connection can expire or lose permission.

Ask Claude to inspect the Nextdns connection.
If the connection is unhealthy, disconnect it when Claude prompts you.
Reconnect the Nextdns account and retry the action.
If Claude shows a permission prompt, approve it before Claude changes data in Nextdns.
If the action still fails with a permission error, check that the connected account has that permission in Nextdns itself.

5. How do I switch to a different Nextdns account?

Claude can manage the Nextdns connection for you.

Ask Claude to disconnect or delete the current Nextdns account.
Ask Claude to connect Nextdns again.
Open the new Composio authorization link for Nextdns.
Sign in with the other Nextdns account in the browser.
After the account connects, ask Claude to retry the Nextdns task.

6. Why is my Nextdns connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Nextdns connection works in Claude Web, Desktop, and Cowork.

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If Nextdns tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Nextdns.

TOOLS

Supported Tools

Every Nextdns action and event your agent gets out of the box.

Add Allowlist Entry

Tool to add a domain to the allowlist of a NextDNS profile.

Add Blocked TLD

Tool to add a top-level domain to the security blocklist for a NextDNS profile.

Add Denylist Domain

Tool to add a domain to the denylist of a NextDNS profile.

Add Parental Control Category

Tool to add a content category to the parental control categories list.

Add Parental Control Service

Tool to add a service to the parental control services list of a NextDNS profile.

Add Privacy Blocklist

Tool to add a blocklist to the privacy blocklists for a NextDNS profile.

Add Privacy Native Tracker

Tool to add a native tracking service to the blocked list for a NextDNS profile.

Add DNS Rewrite Rule

Tool to add a DNS rewrite rule to a NextDNS profile.

Clear Logs

Tool to clear DNS logs for a NextDNS profile.

Create Profile

This tool allows users to create a new NextDNS profile.

Delete Allowlist Entry

Tool to remove a domain from a NextDNS profile's allowlist.

Delete NextDNS Configuration

Tool to delete a NextDNS configuration profile.

Delete Parental Control Category

Tool to remove a category from parental control blocked categories.

Delete Parental Control Service

Tool to remove a service from parental control blocked services.

Delete Privacy Blocklist

Tool to remove a blocklist from the privacy blocklists for a NextDNS profile.

Delete Privacy Native Tracker

Tool to remove a native tracking entry from a NextDNS profile's privacy settings.

Delete DNS Rewrite Rule

Tool to delete a DNS rewrite rule from a NextDNS profile.

Download Logs

Retrieves the download URL for exported DNS query logs from a NextDNS profile.

Get Allowlist

Tool to retrieve the list of allowed domains for a NextDNS profile.

Get Analytics Destinations

Tool to retrieve destination analytics for a profile showing query destinations by country or GAFAM company.

Get Analytics Devices

Tool to retrieve device analytics for a profile showing identified devices with names, models, and query counts.

Get Analytics DNSSEC

Tool to retrieve DNSSEC validation analytics for a profile showing validated vs non-validated query counts.

Get Analytics Domains

Tool to retrieve analytics data for domains within a specific profile.

Get Analytics Encryption

Tool to retrieve encryption analytics for a profile showing encrypted vs unencrypted query counts.

Get Analytics IPs

Tool to retrieve analytics aggregated by client IP addresses.

Get Analytics IP Versions

Tool to retrieve analytics grouped by IP version within a specific profile.

Get Analytics Protocols

Tool to retrieve protocol analytics for a specific profile showing DNS protocol distribution (DNS-over-HTTPS, DNS-over-TLS, UDP).

Get Analytics Query Types

Tool to retrieve DNS query counts broken down by query type.

Get Analytics Blocking Reasons

Tool to retrieve blocking reasons analytics showing blocklists, native tracking protection, and other reasons for blocked queries.

Get Analytics Status

Tool to retrieve analytics status for a specific profile.

Get Logs

Tool to retrieve logs for a specific NextDNS profile with optional filters.

Get Parental Control Settings

Tool to get parental control settings for a profile.

Get Parental Control Categories

Tool to get the list of blocked/allowed content categories for parental control.

Get Parental Control Services

Tool to get the list of blocked/allowed services for parental control.

Get Performance Settings

Tool to get performance settings for a profile including ECS, cache boost, and CNAME flattening configuration.

Get Privacy Settings

Tool to get privacy settings for a profile including blocklists, native tracking settings, disguised trackers, and affiliate settings.

Get Profile Details

Retrieves the details of a specific NextDNS profile.

Get DNS Rewrites

Tool to retrieve the list of DNS rewrites for a NextDNS profile.

Get Security TLDs

Tool to get the list of blocked TLDs (top-level domains) for a profile's security settings.

Get Profile Settings

Tool to get all settings for a NextDNS profile including logs, block page, performance, and web3 settings.

Get Block Page Settings

Tool to retrieve the block page settings for a NextDNS profile.

Get Logging Settings

Tool to retrieve the logging settings for a NextDNS profile.

List Denylist Domains

Tool to list domains in the denylist for a profile.

List Profiles

List all NextDNS profiles for the authenticated user, returning profile IDs and configurations.

List Security Settings

Tool to list current security options for a NextDNS configuration.

Log Client IPs

Tool to enable or disable logging of client IPs for a NextDNS configuration.

Toggle Domain Logging

Tool to enable or disable logging of domains for a NextDNS profile.

Remove Blocked TLD

Tool to remove a top-level domain from the security blocklist for a NextDNS profile.

Remove Denylist Domain

Removes a domain from a NextDNS profile's denylist (blocklist).

Rename Configuration

Tool to rename a NextDNS configuration (profile).

Replace Allowlist

Tool to replace the entire allowlist for a NextDNS profile.

Replace Denylist

Tool to replace the entire denylist (blocked domains) for a NextDNS profile.

Replace Parental Control Categories

Tool to replace the entire list of blocked/allowed content categories for parental control.

Replace Parental Control Services

Tool to replace the entire list of blocked/allowed services for parental control.

Replace Privacy Blocklists

Tool to replace the entire list of privacy blocklists for a NextDNS profile.

Replace Privacy Native Tracking Services

Tool to replace the entire list of blocked native tracking services for a NextDNS profile.

Replace Security TLDs

Tool to replace the entire list of blocked TLDs (top-level domains) for a NextDNS profile's security settings.

Update Allowlist Entry

Tool to update a specific allowlist entry in a NextDNS profile.

Update Denylist Entry

Updates a specific denylist entry in a NextDNS profile, typically to toggle its active status.

Update linked IP

Updates the linked IP address for a NextDNS profile to the current caller's public IP.

Update Parental Control Settings

Tool to update parental control settings for a NextDNS profile.

Update Parental Control Category

Tool to update a specific category entry in parental control settings.

Update Parental Control Service

Tool to update a specific service entry in parental control settings.

Update Performance Settings

Tool to update performance settings of a NextDNS profile.

Update Privacy Settings

Tool to update privacy settings for a profile.

Update Security Settings

Tool to update security settings for a profile.

Update Settings

Tool to update settings for a NextDNS profile including logs, block page, performance, and web3 settings.

Update Block Page Settings

Tool to update block page settings for a NextDNS profile.

FRAMEWORKS

How to build Nextdns MCP Agent with another framework

Claude Code

Use Nextdns MCP with Claude Code

OpenAI Agents SDK

Use Nextdns MCP with OpenAI Agents SDK

Claude Agent SDK

Use Nextdns MCP with Claude Agent SDK

Codex

Use Nextdns MCP with Codex

OpenClaw

Use Nextdns MCP with OpenClaw

Hermes

Use Nextdns MCP with Hermes

Atomic Agent

Use Nextdns MCP with Atomic Agent

Google ADK

Use Nextdns MCP with Google ADK

LangChain

Use Nextdns MCP with LangChain

Vercel AI SDK

Use Nextdns MCP with Vercel AI SDK

Mastra AI

Use Nextdns MCP with Mastra AI

LlamaIndex

Use Nextdns MCP with LlamaIndex

CrewAI

Use Nextdns MCP with CrewAI

Pydantic AI

Use Nextdns MCP with Pydantic AI

AutoGen

Use Nextdns MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Excel

Oauth2S2s Oauth2

Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management.

21risk

Api Key

21RISK is a web app built for easy checklist, audit, and compliance management. It streamlines risk processes so teams can focus on what matters.

Abstract

Api Key

Abstract provides a suite of APIs for automating data validation and enrichment tasks. It helps developers streamline workflows and ensure data quality with minimal effort.

AccuWeather

Api Key

AccuWeather is a global weather service providing current conditions, forecasts, MinuteCast precipitation, alerts, and lightning data. Use it for fast, localized forecasts and real-time weather alerts.

FAQ

Frequently asked questions

With a standalone Nextdns MCP server, the agents and LLMs can only access a fixed set of Nextdns tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Nextdns and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Nextdns tools.

Yes, absolutely. You can configure which Nextdns scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Nextdns data and credentials are handled as safely as possible.

Start with Nextdns.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Nextdns tool your agent needs.Free to start.

Start building

How to connect Nextdns to Claude

Connect Nextdns without auth hassles

Introduction

Also integrate Nextdns with

Connecting Nextdns to Claude Web, Desktop, and Cowork

1. Add with one click

Add manually

2. Authorize in your browser

3. Connect your Nextdns account

What is the Nextdns Claude Connector, and what's possible with it?

Troubleshooting

1. Why does Claude not use the Composio connector for Nextdns?

2. Why does Claude show an MCP server error before Nextdns connects?

3. Why does the Nextdns authorization link not work?

4. Why do Nextdns actions fail after they worked before?

5. How do I switch to a different Nextdns account?

6. Why is my Nextdns connection missing in Claude Desktop or on a Team plan?

Supported Tools

How to build Nextdns MCP Agent with another framework

Claude Code

OpenAI Agents SDK

Claude Agent SDK

Codex

OpenClaw

Hermes

Atomic Agent

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Excel

21risk

Abstract

AccuWeather

Frequently asked questions

What are the differences in Tool Router MCP and Nextdns MCP?+

Can I use Tool Router MCP with Claude Cowork?+

Can I manage the permissions and scopes for Nextdns while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Nextdns.It takes 30 seconds.