How to Use the sevDesk MCP in Claude

Q: How do I check my open invoices using sevDesk and Claude Desktop?

Run the listinvoices tool. It pulls a list of all your invoices, and since it embeds contact data, you'll know right away who owes what.

Q: Can I get details on a specific order using sevDesk and Claude Desktop?

Absolutely. Just provide the necessary identifier to getorder. The tool pulls all associated details for that single sale, making sure you have everything in one place.

Q: Does this MCP Server handle supplier records in sevDesk and Claude Desktop?

Yes. You can list all contacts using listcontacts, which includes both customer and supplier data. It’s designed to manage your vendor information alongside your customers.

Q: What happens if I need to create a new part in sevDesk and Claude Desktop?

You call the createpart tool with the necessary details—name, description, etc. The MCP Server writes it directly into your sevDesk catalog so you don't have to log in manually.

Manage sevDesk records autonomously inside Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect sevDesk MCP to Claude Desktop

Create your Vinkius account to connect sevDesk to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup sevDesk with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automate Financial Record Retrieval

Retrieve specific financial data points using tools like `get_invoice` and `list_invoices`. You can pull full invoice details, including line items and tax rates, without leaving the chat window. Need to check on outstanding payments? Just run `list_orders` or get a detailed view of a single order with `get_order`. This lets you build reports instantly.

Manage sevDesk Contacts and Vendors

Use the MCP Server to handle all your customer and vendor data. Start by calling `list_contacts` to see everyone in sevDesk, or use `get_contact` if you know the ID. When a new client signs up, simply call `create_contact`. It handles both customers and suppliers so you don't have to jump between screens.

Maintain Catalog Integrity

Keep track of products and services using the catalog tools. You can get details on a specific item with `get_part`, or view everything available via `list_parts`. This keeps your pricing data accurate. If you need to add a new service line, call `create_part`. It's fast and ensures the part is linked correctly in sevDesk.

Setup guide

Set up sevDesk 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 sevDesk 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 sevDesk 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 sevdesk-mcp.

json

{
  "mcpServers": {
    "sevdesk-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 sevDesk API. 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 sevDesk 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 sevDesk MCP in Claude Desktop

Run the `list_invoices` tool. It pulls a list of all your invoices, and since it embeds contact data, you'll know right away who owes what.

Absolutely. Just provide the necessary identifier to `get_order`. The tool pulls all associated details for that single sale, making sure you have everything in one place.

Yes. You can list all contacts using `list_contacts`, which includes both customer and supplier data. It’s designed to manage your vendor information alongside your customers.

You call the `create_part` tool with the necessary details—name, description, etc. The MCP Server writes it directly into your sevDesk catalog so you don't have to log in manually.

The server touches Customer/Supplier Contact Records, Invoice Details, and Part Catalog information. All data interactions are handled through the Vinkius secure endpoint token.

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