Skip to content
MCP server

SA Business Calendar

South African business days, public holidays and SARS EMP201 and VAT201 deadlines

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.0.1
Listing updated
1 day ago

About SA Business Calendar

SA Business Calendar is a freemium MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

This server gives an agent exact answers for South African dates instead of guesses from model memory. Its six tools cover whether a date is a weekend or public holiday, the next holiday and days until it, adding or subtracting business days, counting business days between dates, listing holidays in a range, and the next SARS EMP201 and VAT201 due dates adjusted for weekends and holidays.

Holiday handling includes the Sunday-to-Monday observed rule and once-off days declared by the President, such as election days. Only national public holidays are covered, with no provincial or bank-specific days. The SARS rules are simplified for monthly VAT vendors, and the listing says to check sars.gov.za before relying on them for filing.

The server runs on Apify and is billed per call: two tools are free and four cost $0.01 per call, failed calls are not charged, and access uses an Apify API token. The server sleeps when idle, so the first call can take a second or two longer.

Install

Run in a terminal

claude mcp add --transport http sa-business-calendar-mcp https://calendar.namka.cloud/mcp

Add to Settings → Connectors → Add custom connector

https://calendar.namka.cloud/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sa-business-calendar-mcp": {
      "url": "https://calendar.namka.cloud/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "sa-business-calendar-mcp": {
      "type": "http",
      "url": "https://calendar.namka.cloud/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sa-business-calendar-mcp": {
      "serverUrl": "https://calendar.namka.cloud/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "sa-business-calendar-mcp": {
      "type": "http",
      "url": "https://calendar.namka.cloud/mcp"
    }
  }
}

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

is_business_day
Checks whether a date is a weekend or SA public holiday, with the reason.
days_until_next_holiday
Finds the next SA public holiday after a date and the days until it.
add_business_days
Adds or subtracts SA business days, skipping weekends and holidays.
business_days_between
Counts SA business days between two dates.
holidays_in_range
Lists SA public holidays between two dates.
next_sars_deadlines
Lists the next EMP201 and VAT201 due dates adjusted for weekends and holidays.

What it does

Holiday awareness
Knows public holidays, observed Monday rules and once-off declared days.
Business-day maths
Adds, subtracts and counts SA business days.
SARS deadlines
Lists next EMP201 and VAT201 due dates adjusted for holidays.
Holiday ranges
Lists public holidays between two dates.
Pay per event
Two tools are free; the others cost $0.01 per call.
No charge for failures
Failed calls are not billed.

Good for

  • Work out when an invoice on 5-business-day terms is due
  • Find the next EMP201 and VAT201 payment dates
  • Count working days in a month for payroll planning
  • Check whether a date is a working day in South Africa

Pricing

Freemium

Two tools free; four tools $0.01 per call through Apify

Prices change. Check apify.com before you buy.

SA Business Calendar FAQ

Which holidays are covered?

National public holidays under the Public Holidays Act, including Sunday-to-Monday and once-off declared days.

Are provincial or bank holidays included?

No, national public holidays only.

How is it priced?

is_business_day and days_until_next_holiday are free; the other four tools cost $0.01 per call.

Can I rely on it for tax filing?

Not alone; SARS rules are simplified, so verify against sars.gov.za.

Is SA Business Calendar free?

SA Business Calendar has a free plan, with paid plans for more usage or features.

How do I add SA Business Calendar to Claude Code?

Run this command in your terminal: claude mcp add --transport http sa-business-calendar-mcp https://calendar.namka.cloud/mcp

What are the best alternatives to SA Business Calendar?

The closest alternatives to SA Business Calendar are Ha MCP, Concord MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and Budget Tracker.

Alternatives to SA Business Calendar

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  6. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity