# dversum

> dversum is an open-source MCP server for productivity. MCP server giving AI assistants access to a dVersum business workspace for invoices. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web, Self-hosted
- **Repository:** https://github.com/dversum/mcp-server
- **MCP Registry name:** io.github.dversum/mcp-server
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-21

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [gitscrum-core](https://ai-powered.com/mcp/gitscrum-core): gitscrum-core is an MCP server for productivity.
- [IterDone](https://ai-powered.com/mcp/iterdone): IterDone is a freemium MCP server for productivity.
- [Caldav MCP](https://ai-powered.com/mcp/caldav-mcp-2): Caldav MCP is an open-source MCP server for productivity.
- [DrillSpark MCP Server](https://ai-powered.com/mcp/drillspark-mcp-server): DrillSpark MCP Server is an MCP server for productivity.
- [Caldav MCP](https://ai-powered.com/mcp/caldav-mcp): Caldav MCP is an open-source MCP server for productivity.
- [Dida365](https://ai-powered.com/mcp/dida365): Dida365 is an open-source MCP server for productivity.
- [BoondManager MCP Server](https://ai-powered.com/mcp/boondmanager-mcp-server-2): BoondManager MCP Server is an open-source MCP server for sales and crm.
- [Todoist MCP](https://ai-powered.com/mcp/todoist-mcp): Todoist MCP is an open-source MCP server for productivity.

---
Source: https://ai-powered.com/mcp/dversum
