Package Exports

spiritflow-mcp
spiritflow-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (spiritflow-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

spiritflow MCP Server

An MCP (Model Context Protocol) server for the spiritflow Public API. It enables AI assistants like Claude to interact with your spiritflow workspace — manage tasks, projects, time tracking, invoices, and more.

What is spiritflow?

spiritflow is an all-in-one operations platform for small and medium-sized businesses — combining task management, project planning, time tracking, and invoicing in a single system. It is built for teams that do real work: agencies, craft businesses, consulting firms, and IT service providers. Employees always know what to do; managers always know what their team is working on.

Key Features

Task management with status workflows, priorities, recurring tasks, and watchers
Project planning with timeline view and drag-and-drop resource scheduling
Time tracking per task and project, including overtime and leave management
Invoicing with GoBD-compliant sequential numbering and PDF generation
Real-time collaboration via WebSockets — changes are instantly visible to all team members
Customer management with interaction history and CTI (caller identification)
Multi-tenancy — ideal for agencies managing multiple clients or brands
Role-based access control (admin, manager, employee)
GDPR-compliant, EU hosting, user anonymization built in
Public REST API for integrations and automation

Why an MCP Server?

The spiritflow MCP server lets AI assistants work directly with your spiritflow data. Use it to:

Create and update tasks from natural language instructions
Query project status and team workload
Log time entries and manage schedules
Look up customers and communication history
Automate repetitive workflows with AI agents

It works with any MCP-compatible client, including Claude Code, Claude Desktop, and other AI tools that support the Model Context Protocol.

Quick Start

With Claude Code

Add to your Claude Code MCP settings (~/.claude/settings.json or project-level):

{
  "mcpServers": {
    "spiritflow": {
      "command": "npx",
      "args": ["-y", "spiritflow-mcp"],
      "env": {
        "SPIRITFLOW_API_KEY": "sf_live_..."
      }
    }
  }
}

With Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "spiritflow": {
      "command": "npx",
      "args": ["-y", "spiritflow-mcp"],
      "env": {
        "SPIRITFLOW_API_KEY": "sf_live_..."
      }
    }
  }
}

Standalone

SPIRITFLOW_API_KEY=sf_live_... npx spiritflow-mcp

Environment Variables

Variable	Required	Default	Description
`SPIRITFLOW_API_KEY`	Yes	—	Your spiritflow Public API key
`SPIRITFLOW_URL`	No	`https://app.spiritflow.team`	Base URL of your spiritflow instance

Available Tools

The MCP server provides tools for all major spiritflow modules:

Module	Description
Tasks	Create, read, update, and manage tasks — status, assignments, priorities, due dates
Projects	List and manage projects, view members and project tasks
Customers	Full customer management — create, update, list, search
Time Tracking	Log time entries, list and manage tracked time
Receipts & Invoices	Access receipt and invoice data for billing workflows
Users	List workspace users and their roles
Tags	Manage tags for organizing tasks and projects
Search	Full-text search across tasks and other entities
Attachments	List and download file attachments on tasks
Notifications	Access and manage user notifications
Vacation	View and manage vacation/leave requests and balances
Webhooks	Register and manage webhooks for event-driven integrations
Tenant	Access workspace information and settings
CTI	Look up customers by phone number (computer telephony integration)
Interactions	Log and retrieve customer interactions and communication history

API Key & Scopes

Generate an API key in your spiritflow workspace under Settings > API Keys. Each key can be scoped to specific permissions:

tasks:read / tasks:write — Task management
projects:read / projects:write — Project management
customers:read / customers:write — Customer management
time:read / time:write — Time tracking
users:read — User listing
receipts:read / receipts:write — Receipt management
invoices:read — Invoice access
webhooks:read / webhooks:write — Webhook management
tenant:read — Tenant information

About spiritdev

spiritflow is developed by spiritdev Softwareentwicklung GmbH, a German software company based in Reinbek (near Hamburg). spiritdev focuses on digitizing business operations for small and medium-sized enterprises — the backbone of the European economy. Beyond building the platform, spiritdev personally accompanies every customer onboarding: analyzing workflows, migrating data, and connecting spiritflow to existing systems.

License

MIT

spiritflow-mcp