dversum
MCP server giving AI assistants access to a dVersum business workspace for invoices
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-serverAdd 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)RequiredDVERSUM_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.