MCP Fresha MCP Server

MCP server for Fresha Data Connector via Snowflake

Local serverstdioTypeScript

What is the MCP Fresha MCP server?

MCP server for Fresha Data Connector via Snowflake. The mcp fresha mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 3 defined tools rather than through you.

What it actually does

MCP (Model Context Protocol) server for accessing Fresha Data Connector via Snowflake. Query your Fresha business data directly through AI assistants like Claude.

  • Real-time Data Access — Direct connection to your Fresha business data through Snowflake
  • Flexible Querying — Support for date ranges, custom filters, sorting, and pagination
  • Smart Date Parsing — Natural language date inputs like "yesterday", "last week", "this month"
  • Comprehensive Schema Discovery — Automatic discovery of all available tables and their structures
  • Type-safe Operations — Built with TypeScript for reliability and maintainability
  • Mock Mode — Development mode with sample data when Snowflake credentials are not available

Its toolset

Everything the assistant can do here goes through one of these:

  • list_fresha_reports — Lists all available tables and views in your Fresha database
  • get_fresha_report — Get data from any Fresha report/table with flexible filtering options
  • Architecture — The project follows a clean architecture pattern: - Controllers: Business logic for handling data queries and transformations - Services

Configuration

You will need 6 environment variables: SNOWFLAKE_ACCOUNT, SNOWFLAKE_USER, SNOWFLAKE_PASSWORD, SNOWFLAKE_DATABASE, SNOWFLAKE_SCHEMA, SNOWFLAKE_WAREHOUSE. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at mcp-fresha on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

When to reach for it

Plenty of database access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. MCP Fresha's toolset — list_fresha_reports, get_fresha_report, Architecture — is a fair guide to whether it matches your workflow. It is maintained by 199-biotechnologies; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mcp fresha mcp server does with a few real requests.

Available tools

ToolWhat it does
list_fresha_reportsLists all available tables and views in your Fresha database.
get_fresha_reportGet data from any Fresha report/table with flexible filtering options.
ArchitectureThe project follows a clean architecture pattern: - **Controllers**: Business logic for handling data queries and transformations - **Services**: Data access layer with Snowflake connection management - **Tools**: MCP to

How to install the MCP Fresha MCP server

{
  "mcpServers": {
    "fresha": {
      "command": "npx",
      "args": ["-y", "mcp-fresha"],
      "env": {
        "SNOWFLAKE_ACCOUNT": "your-value",
        "SNOWFLAKE_USER": "your-value",
        "SNOWFLAKE_PASSWORD": "your-value",
        "SNOWFLAKE_DATABASE": "your-value",
        "SNOWFLAKE_SCHEMA": "your-value",
        "SNOWFLAKE_WAREHOUSE": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
SNOWFLAKE_ACCOUNTConfiguration value read at startup.Optional
SNOWFLAKE_USERConfiguration value read at startup.Optional
SNOWFLAKE_PASSWORDConfiguration value read at startup.Optional
SNOWFLAKE_DATABASEConfiguration value read at startup.Optional
SNOWFLAKE_SCHEMAConfiguration value read at startup.Optional
SNOWFLAKE_WAREHOUSEConfiguration value read at startup.Optional

Example prompts to try

  • Use MCP Fresha to list fresha reports.
  • Use MCP Fresha to get fresha report.
  • Use MCP Fresha to Architecture.

Frequently asked questions

It connects MCP Fresha to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (list_fresha_reports, get_fresha_report, Architecture) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Fresha directly.