Deploy and Host Bexio MCP on Railway

Connect your bexio workflows with compatible AI applications and automation tools. Bexio MCP is a community-developed integration offering tools for contacts, invoices, quotes, accounting, projects and more. This Railway template helps you host the MCP server centrally, with token-protected HTTP access to your own bexio account.

About Hosting Bexio MCP

Hosting Bexio MCP on Railway provides a central HTTP service for your integrations. Supply your bexio Personal Access Token and connect your applications using the separate HTTP authentication token generated by the template.

The startup configuration checks credentials, timezone and file storage before launching the server. Attach a persistent volume at /data; this is required by the configured startup checks. The default timezone is Europe/Zurich, while a custom TZ value takes precedence.

Use one service instance with the attached volume. Available operations depend on your bexio permissions and subscribed modules. No separate application database is required.

Common Use Cases

Prepare invoice drafts and quotes from connected applications.
Retrieve customer details, outstanding invoices and payment information.
Use accounting records, project data and time entries in reports and workflows.

Dependencies for Bexio MCP Hosting

A bexio account and Personal Access Token with appropriate permissions.
A Railway project with a persistent volume mounted at /data.
A client that supports the server’s HTTP interface and bearer authentication.
Any additional bexio modules required by your workflows.

Implementation Details

Root directory: /src
HTTP endpoint: https://YOUR_DOMAIN/mcp
Authentication header: Authorization: Bearer YOUR_HTTP_TOKEN
Health check: /
Persistent file storage: /data/files
Default port: 8080
Service instances: 1

Replace YOUR_DOMAIN with your service domain and YOUR_HTTP_TOKEN with the generated BEXIO_HTTP_TOKEN.

The upstream server uses a custom HTTP/JSON-RPC implementation. Compatibility with clients requiring standard MCP Streamable HTTP or OAuth must be verified separately.

Downloaded files stored on the server are not public download links. Stored files require periodic cleanup.

Why Deploy Bexio MCP on Railway?

Railway brings deployment, environment variables, logs and persistent storage into one place. Run your bexio integration alongside your applications and automation services without managing a virtual machine.

Adjust compute resources as your workload grows and manage the service from one dashboard. This configuration uses one instance with an attached volume.

Credits & License

Bexio MCP Server is developed by Lukas Hertig at PromptPartner.ai, building on the original implementation by Sebastian Bryner at bryner.tech.

The MCP server is distributed under the MIT License. All credit for the server belongs to its authors and contributors.

Independent Community Template

This independently maintained Railway template provides deployment configuration for the MCP server. The template author does not develop or own the upstream MCP server or the bexio business software.

This is a community template, not an official offering from PromptPartner or bexio AG. No affiliation, partnership, sponsorship or endorsement by either company is claimed.

bexio Trademark & Ownership Notice

The bexio business software is provided by bexio AG. The bexio name and associated trademarks belong to their respective rights holders.

The name “bexio” is used solely to identify the service with which this integration is compatible. Neither this template nor the MCP server grants any ownership or trademark rights in bexio.

The MCP server’s MIT License does not apply to the proprietary bexio software or services. Using this integration requires your own bexio account and API credentials and remains subject to bexio’s applicable terms.