Skip to main content
Glama
dversum

dVersum MCP Server

Official
by dversum

@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):

{
  "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:

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

Related MCP server: TimePRO MCP Server

Docker (Production)

Quick start

cd mcp-server

# Create .env file
echo "DVERSUM_API_URL=https://api.dversum.com/api/v1" > .env
echo "DVERSUM_API_TOKEN=your-jwt-token" >> .env

# Run
docker compose up -d

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

Build & run manually

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:

{
  "mcpServers": {
    "dversum": {
      "url": "http://your-server:3100/mcp"
    }
  }
}

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)

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

Contacts (5)

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

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)

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

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)

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

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)

Tool

Description

list_tags

List all tags

create_tag

Create a tag

update_tag

Update a tag

delete_tag

Delete a tag

Areas (4)

Tool

Description

list_areas

List project areas/groups

create_area

Create a project area

update_area

Update an area

delete_area

Delete an area

Notifications (4)

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

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

# Clone the repo
git clone https://github.com/dversum/dversum.git
cd dversum/mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run locally
DVERSUM_API_URL=http://localhost:8080/api/v1 \
DVERSUM_API_TOKEN=your-jwt-token \
node dist/bin/dversum-mcp.js

License

MIT

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dversum/mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server