Skip to content
MCP serverOfficial: Published to the official MCP Registry by the GitHub account or domain it is named after, which owns its code or website.

dversum

MCP server giving AI assistants access to a dVersum business workspace for invoices

Runs locally
Install

dversum is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, API, Web
Runs
Locally
Version
2.0.0
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add mcp-server --env DVERSUM_API_URL='<DVERSUM_API_URL>' --env DVERSUM_API_TOKEN='<DVERSUM_API_TOKEN>' -- npx -y @dversum/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@dversum/mcp-server"
      ],
      "env": {
        "DVERSUM_API_URL": "<DVERSUM_API_URL>",
        "DVERSUM_API_TOKEN": "<DVERSUM_API_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@dversum/mcp-server"
      ],
      "env": {
        "DVERSUM_API_URL": "<DVERSUM_API_URL>",
        "DVERSUM_API_TOKEN": "<DVERSUM_API_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@dversum/mcp-server"
      ],
      "env": {
        "DVERSUM_API_URL": "<DVERSUM_API_URL>",
        "DVERSUM_API_TOKEN": "<DVERSUM_API_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@dversum/mcp-server"
      ],
      "env": {
        "DVERSUM_API_URL": "<DVERSUM_API_URL>",
        "DVERSUM_API_TOKEN": "<DVERSUM_API_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@dversum/mcp-server"
      ],
      "env": {
        "DVERSUM_API_URL": "<DVERSUM_API_URL>",
        "DVERSUM_API_TOKEN": "<DVERSUM_API_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • DVERSUM_API_URLBase URL of your dVersum API (e.g. https://api.dversum.com/api/v1)Required
  • DVERSUM_API_TOKENYour dVersum JWT authentication token (get it from Settings > API Tokens)Required

About dversum

Connects AI assistants such as Claude Desktop, Cursor and Windsurf to a dVersum workspace, so the assistant can read and change clients, projects, tasks, invoices, quotes, time entries and calendar events through natural-language requests. It runs over stdio via npm or as a Docker-hosted HTTP endpoint on port 3100.

The server exposes around 150 tools grouped by area, covering invoicing workflows such as converting accepted quotes into invoices, recording payments, creating credit notes and sending reminders, along with VAT summaries and DATEV export previews for German bookkeeping. Access is authenticated with a personal JWT token generated in the dVersum settings.

It suits freelancers and small teams who already run their billing and project tracking in dVersum and want to handle routine admin through an AI assistant.

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

list_clients
List all clients with pagination
create_invoice
Create a draft invoice
create_invoice_from_time
Create invoice from tracked time
record_payment
Record a payment on an invoice
start_timer
Start a running timer
stop_timer
Stop a running timer
get_vat_summary
USt-Voranmeldung (KZ 81/86/66/83)
list_events
List calendar events in a date range

What it does

Client and contact management
Create, read, update and delete clients and their contacts from an assistant.
Project and task boards
Work with kanban boards, tasks, subtasks, comments, assignees and Gantt data.
Time tracking
Start and stop timers, log time entries and pull time statistics.
Invoices and quotes
Draft, update, send and record payments on invoices and quotes, including recurring invoices.
Finance overview
Review monthly revenue against expenses, VAT summaries and supplier invoices.
Docker or local deployment
Run over stdio for desktop clients or as a containerised HTTP server.

Good for

  • Drafting an invoice from tracked time at the end of the month
  • Checking which invoices are overdue and sending payment reminders
  • Logging time entries and starting or stopping timers during a workday
  • Updating project kanban boards and assigning tasks to team members
  • Reviewing team absences and vacation balances when planning projects

Pricing

Open source

dversum FAQ

Which AI clients can use dversum?

The README names Claude Desktop, Cursor and Windsurf, and describes a remote HTTP endpoint for Docker deployments.

What do I need to run dversum?

A dVersum API URL and a JWT API token, which you create under Settings > API Tokens in dVersum.

How many tools does dversum provide?

The README lists 152 tools across clients, projects, tasks, time tracking, calendar, invoices, quotes, finance, pages, files and more.

What is the licence?

The project is released under the MIT licence.

Is dversum free?

Yes. dversum is open source, so you can use and self-host it for free.

How do I add dversum to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env DVERSUM_API_URL='<DVERSUM_API_URL>' --env DVERSUM_API_TOKEN='<DVERSUM_API_TOKEN>' -- npx -y @dversum/mcp-server

What are the best alternatives to dversum?

The closest alternatives to dversum are gitscrum-core, IterDone, Caldav MCP, DrillSpark MCP Server and Caldav MCP.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers