Skip to main content
Glama

banglakit

test License: Apache-2.0 good first issues

Bangla (বাংলা) and Bangladesh tools for people and AI agents. Taka in words, the Bangla calendar, every district and upazila, official public holidays, phone numbers and phonetic typing, ready for Claude, Codex, Cursor or any MCP agent, plus a CLI and a JavaScript library.

300 million people speak Bangla, yet AI agents still get the basics wrong: they write taka amounts in the Western million system, guess the Bangla date, and can't read Bangla typed in English letters. banglakit gives them exact, tested tools instead of guesses.

  • Exact: rules and official data, not AI guesses. Every result is deterministic and covered by tests.

  • Sourced: every dataset links to its Government of Bangladesh source (data/README.md).

  • Local: no network, no account, no data leaves your machine.

  • Free: Apache-2.0.

Use it in your AI agent (MCP)

Claude Code

claude mcp add banglakit -- npx -y @arafatsec/banglakit mcp

Claude Desktop / Cursor / any MCP client (add to the client's MCP config):

{ "mcpServers": { "banglakit": { "command": "npx", "args": ["-y", "@arafatsec/banglakit", "mcp"] } } }

Then just ask: "Write ১,২৫,০০০.৫০ taka in words for this cheque", "Is 26 March a holiday?" or "Which district is Savar in?"

Tool

What it does

Example

taka_in_words

Amount in words for cheques and invoices

125000.50 → এক লক্ষ পঁচিশ হাজার টাকা পঞ্চাশ পয়সা মাত্র

number_to_words

Number in Bangla or English words, lakh/crore

1234567 → বারো লক্ষ চৌত্রিশ হাজার পাঁচ শত সাতষট্টি

format_number

Lakh/crore digit grouping

12345678 → ১,২৩,৪৫,৬৭৮

convert_digits

0-9 ⇄ ০-৯ inside any text

2026 → ২০২৬

bangla_date

Gregorian → Bangla date, weekday, season

2026-02-21 → ৮ ফাল্গুন ১৪৩২ বঙ্গাব্দ

gregorian_date

Bangla date → Gregorian

1433 1 1 → 2026-04-14

phonetic_to_bangla

English letters → Bangla script

ami banglay gan gai → আমি বাংলায় গান গাই

find_area

Find a division, district or upazila (Bangla or English)

savar → সাভার, Dhaka district, Dhaka division

list_areas

Divisions → districts → upazilas

district: gazipur → গাজীপুর সদর, কালিয়াকৈর...

bd_holidays

Official public holidays (general, executive, optional)

2026, month 3 → ঈদ-উল-ফিতর, স্বাধীনতা দিবস...

is_holiday

Is this date a holiday?

2026-12-16 → বিজয় দিবস

parse_phone

Check a mobile number, normalise, name the operator

০১৭১২৩৪৫৬৭৮ → +8801712345678, Grameenphone

Related MCP server: @vn-skills/mcp

Command line

npx @arafatsec/banglakit taka 125000.50          # এক লক্ষ পঁচিশ হাজার টাকা পঞ্চাশ পয়সা মাত্র
npx @arafatsec/banglakit taka 125000 --en        # one lakh twenty-five thousand taka only
npx @arafatsec/banglakit date                    # today, e.g. শুক্রবার, ৫ অগ্রহায়ণ ১৪৩৩ বঙ্গাব্দ, হেমন্তকাল
npx @arafatsec/banglakit gdate 1433 1 1          # 2026-04-14
npx @arafatsec/banglakit type amar sOnar bangla  # আমার সোনার বাংলা
npx @arafatsec/banglakit format 12345678         # ১,২৩,৪৫,৬৭৮
npx @arafatsec/banglakit area savar              # upazila সাভার · Dhaka · Dhaka
npx @arafatsec/banglakit holidays 2026 12        # 2026-12-16 বুধবার বিজয় দিবস (Victory Day) ...
npx @arafatsec/banglakit phone 01712345678       # +8801712345678 · Grameenphone

Library

npm install @arafatsec/banglakit
import { takaInWords, toBanglaDate, phoneticToBangla, findArea, holidaysOn, parsePhone } from "@arafatsec/banglakit";

takaInWords("1,250.50");           // "এক হাজার দুই শত পঞ্চাশ টাকা পঞ্চাশ পয়সা মাত্র"
toBanglaDate("2026-12-16").text;   // "১ পৌষ ১৪৩৩ বঙ্গাব্দ"
findArea("savar")[0].district;     // "Dhaka"
holidaysOn("2026-03-26")[0].name_bn; // "স্বাধীনতা ও জাতীয় দিবস"
parsePhone("01912345678").operator; // "Banglalink"
phoneticToBangla("kemon achhO");   // "কেমন আছো"

How the rules work

Bangla calendar. The official Bangladesh calendar since the 2019 revision: the year starts on 14 April; Boishakh to Ashwin have 31 days; Kartik, Ogrohayon, Poush, Magh and Choitro have 30; Falgun has 29, or 30 in a Gregorian leap year. So 21 February is always ৮ ফাল্গুন, 26 March ১২ চৈত্র and 16 December ১ পৌষ. (The West Bengal calendar differs and is on the roadmap.)

Phonetic typing (similar to the well-known Avro style, written from scratch):

Type

Get

Type

Get

Type

Get

a / i / I

া / ি / ী

u / U

ু / ূ

e / O

ে / ো

oi / ou

ৈ / ৌ

rri

ৃ

o

inherent অ

T Th D Dh

ট ঠ ড ঢ

t th d dh

ত থ দ ধ

N / n

ণ / ন

sh / S or Sh / s

শ / ষ / স

R / Rh

ড় / ঢ়

ng / Ng

ং / ঙ

ch / chh

চ / ছ

kkh or kSh

ক্ষ

y after a consonant

্য (য-ফলা)

w after a consonant

্ব (ব-ফলা)

t ``

ৎ

^ / :

ঁ / ঃ

.

।

{english}

kept as typed

0-9

০-৯

Two consonants in a row join into a conjunct (rokto → রক্ত). Type o between them to keep them apart (kolokata → কলকাতা).

Roadmap (help wanted)

  • Postcodes for every post office (Bangladesh Post publishes them per district)

  • English names for every upazila

  • Holiday lists for 2027 onward

  • Bijoy (ANSI) ⇄ Unicode converter for old government and office documents

  • Bangla OCR and speech-to-text tools (wrapping open models)

  • West Bengal (Indian) Bangla calendar

  • Conjunct whitelist for smarter phonetic typing; more words in tests

  • Bangla number words for ordinals (প্রথম, দ্বিতীয়...) and dates written in words

  • Python package

See CONTRIBUTING.md. Good first issues are labelled good first issue.

License

Apache-2.0. Made in Dhaka by Elaichix and contributors.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides over 500 deterministic tools for math, conversions, validation, hashing, and more, enabling AI agents to perform accurate calculations and data transformations without hallucination.
      1
      MIT
    • A
      license
      B
      quality
      A
      maintenance
      Enables AI agents to build and parse VietQR payments, convert old 63-province addresses to the 34-province structure, validate tax IDs and e-invoices, turn money amounts into Vietnamese words, and convert between solar and lunar calendar dates. All tools run offline with bundled data, returning structured ok/error results.
      40
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to query Türkiye-specific data and logic without API keys: official central-bank exchange rates and currency conversion, live AFAD/Kandilli earthquakes, the official holiday calendar with business-day math, IBAN/TCKN/VKN validation, province and district lookup, prayer times, weather forecasts, plus Turkish-correct text casing and amounts written out in words. All 17 tools are read-only, with most working fully offline.
      17
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude to deterministically normalize Pakistani phone numbers, convert between Latin and Urdu digit scripts, compute Hijri dates, and format rupee amounts in lakh/crore notation with Urdu word forms. All helpers run locally with no network access or stored data.
      5
      MIT