Back to Browse
Free
Server data from the Official MCP Registry
Manage clients, projects, tasks, invoices, time tracking & calendar in dVersum.
About
Manage clients, projects, tasks, invoices, time tracking & calendar in dVersum.
Documentation
View on GitHubFrom the project's GitHub 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):
{
"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
What You'll Need
Set these up before or after installing:
Base URL of your dVersum API (e.g. https://api.dversum.com/api/v1)
Environment variable: DVERSUM_API_URL
Your dVersum JWT authentication token (get it from Settings > API Tokens)Required
Environment variable: DVERSUM_API_TOKEN
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-dversum-mcp-server": {
"env": {
"DVERSUM_API_URL": "your-dversum-api-url-here",
"DVERSUM_API_TOKEN": "your-dversum-api-token-here"
},
"args": [
"-y",
"@dversum/mcp-server"
],
"command": "npx"
}
}
}Security Report
4.8
Use Caution4.8High RiskThis is a well-structured MCP server for the dVersum business management platform with proper authentication via environment variables and appropriate security practices. The server requires a JWT token for authentication and communicates with the dVersum API over HTTPS, showing good security design for a developer tools integration. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 7 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
396
Installs
10.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
49
Installs
10.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
13
Installs
10.0
Security
5.0
Local