Dversum

io.github.dversumPublished by GitHub account dversumv2.0.0Updated Oct 24, 2026

Manage clients, projects, tasks, invoices, time tracking & calendar in dVersum.

VerifiedSTDIODesktop onlyProductivity & Workflow Finance Business & Commerce

Server details

Identifier: io.github.dversum/mcp-server
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account dversum for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.dversum%2Fmcp-server.svg)](https://sourceweft.com/mcp/io.github.dversum%2Fmcp-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Official dVersum MCP server that lets an assistant manage clients, projects, tasks, time tracking, invoices, quotes and calendar in a dVersum workspace.

What you can do: List, create, update and delete clients, contacts, projects, kanban columns, tasks, subtasks, comments, tags and areas
Log, edit and delete time entries, start and stop timers, and read time statistics
Create, edit, send and track invoices, quotes, recurring invoices, payment reminders, credit notes and cancellations
Record payments, review revenue and VAT summaries, approve received invoices, manage suppliers and preview DATEV export data
Manage calendar events, team absences and vacation statistics
Work with pages, whiteboards, folders, files and share links, plus notifications, organization members and global search
When to use it: Useful when you run your business on dVersum and want an assistant to draft invoices or quotes, update project boards, log time, check finances or look things up across the workspace without switching apps.
Requirements: Runs locally via npx from the npm package, or in Docker with an HTTP transport on port 3100. Requires the DVERSUM_API_URL base URL and a DVERSUM_API_TOKEN JWT taken from the dVersum settings, plus network access to that API.

Before you install

The token grants access to a whole business workspace, so keep it out of shared configs. Many tools write, send or delete data: invoices and reminders can be emailed to customers, payments recorded, members invited or removed, and files, folders and pages deleted. Review actions before confirming.

Installation

In SourceWeft

Open Dversum in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@dversum/mcp-server

Official Model Context Protocol (MCP) server for the dVersum business management API. Lets AI assistants like Claude Desktop, Cursor, and Windsurf interact with your dVersum workspace — managing clients, projects, tasks, invoices, time tracking, and more.

Quick Start

Claude Desktop

Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

json

{  "mcpServers": {    "dversum": {      "command": "npx",      "args": ["-y", "@dversum/mcp-server"],      "env": {        "DVERSUM_API_URL": "https://api.dversum.com/api/v1",        "DVERSUM_API_TOKEN": "your-jwt-token"      }    }  }}

{  "mcpServers": {    "dversum": {      "command": "npx",      "args": ["-y", "@dversum/mcp-server"],      "env": {        "DVERSUM_API_URL": "https://api.dversum.com/api/v1",        "DVERSUM_API_TOKEN": "your-jwt-token"      }    }  }}

Cursor / Windsurf

Add to your MCP settings:

json

{  "mcpServers": {    "dversum": {      "command": "npx",      "args": ["-y", "@dversum/mcp-server"],      "env": {        "DVERSUM_API_URL": "https://api.dversum.com/api/v1",        "DVERSUM_API_TOKEN": "your-jwt-token"      }    }  }}

{  "mcpServers": {    "dversum": {      "command": "npx",      "args": ["-y", "@dversum/mcp-server"],      "env": {        "DVERSUM_API_URL": "https://api.dversum.com/api/v1",        "DVERSUM_API_TOKEN": "your-jwt-token"      }    }  }}

Docker (Production)

Quick start

bash

cd mcp-server
# Create .env fileecho "DVERSUM_API_URL=https://api.dversum.com/api/v1" > .envecho "DVERSUM_API_TOKEN=your-jwt-token" >> .env
# Rundocker compose up -d

cd mcp-server
# Create .env fileecho "DVERSUM_API_URL=https://api.dversum.com/api/v1" > .envecho "DVERSUM_API_TOKEN=your-jwt-token" >> .env
# Rundocker compose up -d

The server starts on port 3100 with a health check at /health and the MCP endpoint at /mcp.

Build & run manually

bash

docker build -t dversum-mcp .docker run -d \  -p 3100:3100 \  -e DVERSUM_API_URL=https://api.dversum.com/api/v1 \  -e DVERSUM_API_TOKEN=your-jwt-token \  --name dversum-mcp \  --restart unless-stopped \  dversum-mcp

docker build -t dversum-mcp .docker run -d \  -p 3100:3100 \  -e DVERSUM_API_URL=https://api.dversum.com/api/v1 \  -e DVERSUM_API_TOKEN=your-jwt-token \  --name dversum-mcp \  --restart unless-stopped \  dversum-mcp

Connect remote MCP to Claude Desktop

Once the Docker container is running, point Claude Desktop to the remote endpoint:

Environment Variables

Variable	Required	Description
`DVERSUM_API_URL`	Yes	Base URL of your dVersum API (e.g. `https://api.dversum.com/api/v1`)
`DVERSUM_API_TOKEN`	Yes	Your JWT authentication token
`MCP_TRANSPORT`	No	`stdio` (default) or `http` (for Docker/remote)
`MCP_PORT`	No	HTTP port when using `http` transport (default: `3100`)

Available Tools (152)

Clients (5)

Contacts (5)

Projects (12)

Tool	Description
`list_projects`	List all projects
`get_project`	Get project details
`create_project`	Create a new project
`update_project`	Update project details
`delete_project`	Delete a project
`get_project_board`	Get full kanban board (columns + tasks)
`list_project_members`	List project members
`add_project_member`	Add a member to a project
`remove_project_member`	Remove a member from a project
`get_project_time_stats`	Get project time statistics
`get_gantt_data`	Get Gantt chart data with dependencies
`create_column`	Create a kanban column

Tasks (16)

Tool	Description
`get_task`	Get task details (assignees, subtasks, tags)
`create_task`	Create a task in a project column
`update_task`	Update task properties
`delete_task`	Delete a task
`move_task`	Move task to a different column
`assign_task`	Add an assignee to a task
`remove_assignee`	Remove an assignee from a task
`list_task_comments`	List comments on a task
`create_comment`	Add a comment to a task
`create_subtask`	Create a subtask (checklist item)
`toggle_task_done`	Toggle task completion
`add_tag_to_task`	Add a tag to a task
`remove_tag_from_task`	Remove a tag from a task
`archive_task`	Archive a task
`restore_task`	Restore an archived task
`move_task_to_project`	Move task to a different project

Time Tracking (8)

Tool	Description
`list_time_entries`	List time entries (filter by date, project)
`create_time_entry`	Log a completed time entry
`update_time_entry`	Update a time entry
`delete_time_entry`	Delete a time entry
`start_timer`	Start a running timer
`stop_timer`	Stop a running timer
`get_running_timer`	Get the currently running timer
`get_time_stats`	Get time tracking statistics

Calendar (5)

Invoices (14)

Tool	Description
`list_invoices`	List invoices (filter by status, client, type)
`get_invoice`	Get invoice with line items and totals
`create_invoice`	Create a draft invoice
`update_invoice`	Update a draft invoice
`delete_invoice`	Delete a draft invoice
`update_invoice_status`	Change invoice status
`send_invoice_email`	Send invoice via email
`create_invoice_from_time`	Create invoice from tracked time
`add_invoice_line_item`	Add a line item
`update_invoice_line_item`	Update a line item
`delete_invoice_line_item`	Delete a line item
`record_payment`	Record a payment on an invoice
`create_credit_note`	Create a credit note (Gutschrift)
`create_cancellation`	Create a cancellation invoice (Stornorechnung)

Quotes (12)

Tool	Description
`list_quotes`	List quotes/proposals
`get_quote`	Get quote with line items
`create_quote`	Create a draft quote
`update_quote`	Update a quote
`delete_quote`	Delete a quote
`update_quote_status`	Update quote status
`send_quote_email`	Send quote via email
`duplicate_quote`	Duplicate a quote
`convert_quote_to_invoice`	Convert accepted quote to invoice
`add_quote_line_item`	Add a line item
`update_quote_line_item`	Update a line item
`delete_quote_line_item`	Delete a line item

Recurring Invoices (8)

Tool	Description
`list_recurring_invoices`	List recurring invoice templates
`get_recurring_invoice`	Get recurring invoice details
`create_recurring_invoice`	Create a recurring invoice
`update_recurring_invoice`	Update a recurring invoice
`delete_recurring_invoice`	Delete a recurring invoice
`pause_recurring_invoice`	Pause auto-generation
`resume_recurring_invoice`	Resume auto-generation
`generate_recurring_invoice_now`	Generate an invoice now

Payment Reminders (6)

Tool	Description
`list_reminders`	List payment reminders (Mahnungen)
`get_reminder`	Get reminder details
`get_reminder_suggestion`	Get suggested reminder for overdue invoice
`create_reminder`	Create a payment reminder
`send_reminder_email`	Send reminder via email
`delete_reminder`	Delete a reminder

Finance (11)

Tool	Description
`get_finance_overview`	Monthly revenue vs expenses
`get_vat_summary`	USt-Voranmeldung (KZ 81/86/66/83)
`list_received_invoices`	List incoming invoices
`get_received_invoice`	Get received invoice details
`approve_received_invoice`	Approve a received invoice
`list_suppliers`	List all suppliers
`get_supplier`	Get supplier details
`create_supplier`	Create a supplier
`update_supplier`	Update supplier details
`delete_supplier`	Delete a supplier
`get_datev_export`	Preview DATEV export data

Team Planning (5)

Pages (7)

Tool	Description
`list_pages`	List all pages
`get_page`	Get page with content
`create_page`	Create a new page
`update_page`	Update page metadata
`update_page_content`	Update page content
`delete_page`	Delete a page and children
`get_page_tree`	Get page tree hierarchy

Whiteboards (6)

Tool	Description
`list_whiteboards`	List all whiteboards
`get_whiteboard`	Get whiteboard with content
`create_whiteboard`	Create a whiteboard
`update_whiteboard`	Update whiteboard metadata
`delete_whiteboard`	Delete a whiteboard
`duplicate_whiteboard`	Duplicate a whiteboard

File Storage (12)

Tool	Description
`list_files`	List files in a folder
`get_file`	Get file details
`delete_file`	Delete a file
`get_file_download_url`	Get presigned download URL
`list_folders`	List folders
`create_folder`	Create a new folder
`update_folder`	Update folder name/color
`delete_folder`	Delete a folder and contents
`get_folder_tree`	Get full folder hierarchy
`create_share_link`	Create a WeTransfer-style share link
`list_share_links`	List active share links
`revoke_share_link`	Revoke a share link

Tags (4)

Areas (4)

Notifications (4)

Organization (8)

Tool	Description
`get_organization`	Get organization details
`update_organization`	Update organization settings
`list_members`	List team members
`invite_member`	Invite a new member via email
`update_member_role`	Change a member's role
`remove_member`	Remove a member
`global_search`	Search across all entities
`get_activity_feed`	Get recent activity feed

Development

bash

# Clone the repogit clone https://github.com/dversum/dversum.gitcd dversum/mcp-server
# Install dependenciesnpm install
# Buildnpm run build
# Run locallyDVERSUM_API_URL=http://localhost:8080/api/v1 \DVERSUM_API_TOKEN=your-jwt-token \node dist/bin/dversum-mcp.js

# Clone the repogit clone https://github.com/dversum/dversum.gitcd dversum/mcp-server
# Install dependenciesnpm install
# Buildnpm run build
# Run locallyDVERSUM_API_URL=http://localhost:8080/api/v1 \DVERSUM_API_TOKEN=your-jwt-token \node dist/bin/dversum-mcp.js

License

MIT

Source: README.md at commit 48e0a39

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v2.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Tool	Description
`list_clients`	List all clients with pagination
`get_client`	Get client details
`create_client`	Create a new client
`update_client`	Update client details
`delete_client`	Delete a client

Tool	Description
`list_contacts`	List all contacts
`get_contact`	Get contact details
`create_contact`	Create a new contact
`update_contact`	Update contact details
`delete_contact`	Delete a contact

Tool	Description
`list_events`	List calendar events in a date range
`get_event`	Get event details
`create_event`	Create a calendar event
`update_event`	Update an event
`delete_event`	Delete an event

Tool	Description
`list_absences`	List team absences
`create_absence`	Create an absence entry
`update_absence`	Update an absence
`delete_absence`	Delete an absence
`get_vacation_stats`	Get vacation quota/usage stats

Tool	Description
`list_tags`	List all tags
`create_tag`	Create a tag
`update_tag`	Update a tag
`delete_tag`	Delete a tag

Tool	Description
`list_areas`	List project areas/groups
`create_area`	Create a project area
`update_area`	Update an area
`delete_area`	Delete an area

Tool	Description
`list_notifications`	List recent notifications
`get_unread_count`	Get unread notification count
`mark_notification_read`	Mark a notification as read
`mark_all_notifications_read`	Mark all as read