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

Links

• spiritflow Website
• spiritdev Website
• MCP Protocol
• GitHub Repository