Mcp Server

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

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