How to Use the Ninox MCP in Claude

Q: Can Claude Desktop run complex Ninox scripts for me?

Yes. The executeninoxscript tool is built for exactly that. You provide the Ninox script as a string, and your agent runs it against your database, returning the result directly in your chat.

Stop exporting CSVs. Ask Claude Desktop to query, create, and update your Ninox databases directly from the chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ninox MCP to Claude Desktop

Create your Vinkius account to connect Ninox to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Ninox with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Talk to Your Database

This toolset lets your AI client manage Ninox records for you. Tell Claude to `list_records` from your 'Customers' table and it will pull the data right into your chat. Need to fix a typo? Just ask it to `update_record` with the correct info. You can also create and delete records on the fly. Use `create_records` to add a new lead from a conversation or `delete_record` to clean up old test entries. It's like having a database assistant who knows your Ninox setup.

Inspect and Script Your Ninox MCP Server

Before you start changing data, you need to know the layout. Use `get_database_schema` to have Claude show you the exact structure of any table, including field names and types. You can also `list_databases` to see everything available in your workspace. For more complex jobs, there's `execute_ninox_script`. You can write a custom Ninox formula—for batch updates, complex lookups, anything—and have your agent run it securely. This is how you automate the tricky stuff without leaving your chat window.

Full Database Control

This MCP server gives you the fundamental database operations. You can `get_record` to pull a specific customer's details or `list_records` to see all open orders from the last week. No more manual searching in the Ninox UI. The real power comes from combining them. Find a record, ask your AI client to analyze it, then tell it to `update_record` with new information. This turns your database into a dynamic part of your workflow, not just a static storage bin.

Setup guide

Set up Ninox MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Ninox MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Ninox MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under ninox-mcp.

json

{
  "mcpServers": {
    "ninox-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Ninox. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Ninox now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Ninox MCP in Claude Desktop

In the Claude Desktop app, go to Settings and add the MCP server. If you're on the web at claude.ai, paste the server URL into the Custom Connectors section. Your tools for Ninox will show up right away.

Yes. The `execute_ninox_script` tool is built for exactly that. You provide the Ninox script as a string, and your agent runs it against your database, returning the result directly in your chat.

It is. The MCP server connects using your provided credentials, and all operations are sandboxed. The server only performs the actions you explicitly ask your agent to do, like `get_record` or `update_record`.

Speed and context. You don't have to switch apps or export data. You can ask Claude a question about a customer, have it pull the data from Ninox with `get_record`, and then draft an email based on that data, all in one conversation.

Your Ninox record and schema data is only passed through the server when a tool is actively running. Vinkius uses ephemeral, zero-trust sandboxes for each request, meaning no data is stored after the operation completes. Your authentication token is encrypted and managed by Vinkius.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript