Skip to content

oomh/sape

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MpesaLens

Understand where your M-Pesa money goes.

MpesaLens analyzes your M-Pesa PDF statements and shows you exactly how and where you've spent your money. Filter by date, search by merchant or person, and discover your spending patterns.

Launch App


What MpesaLens Does

MpesaLens helps you understand your M-Pesa spending by:

  • Categorizing all transactions - Automatically groups your transactions into Lipa Na M-Pesa, transfers, airtime, withdrawals, and more
  • Filtering by date - View spending for specific dates or date ranges
  • Searching by entity - Find all transactions with a specific merchant, person, or service
  • Visualizing patterns - See charts and summaries of where your money goes
  • Showing transaction details - Click any category to see individual transaction amounts, dates, and recipients

How to Use

Get Your Statement

Open the M-Pesa app, MySafaricom app, or dial *334# and request your statement. You'll receive a PDF via email.

Upload and Analyze

  1. Visit MpesaLens
  2. Upload your PDF statement
  3. Enter the password if your PDF is protected
  4. Click Process

Explore Your Data

  • Browse transactions organized by category
  • Use the date filter to focus on specific time periods
  • Search for specific merchants or people
  • Click on any category to see detailed transaction lists
  • View charts showing your spending breakdown

Transaction Categories

Lipa Na M-Pesa

  • Buy Goods - Purchases at shops and merchants
  • Pay Bill - Utility bills, subscriptions, and services
  • Pochi La Biashara - Small business and vendor payments

Money Movement

  • Transfers - Money sent to other M-Pesa users
  • Received - Money received from others
  • Withdrawals - Cash withdrawn from agents

Mobile Services

  • Airtime and data bundles
  • Deposits and other mobile transactions

Privacy

Your data stays on your device. MpesaLens processes everything locally in your browser and doesn't store, upload, or transmit your statements anywhere. No account required, no personal information collected.


Important Notes

Categorization Accuracy

MpesaLens automatically categorizes transactions based on M-Pesa descriptions. Since these descriptions can vary, some transactions may be miscategorized. You can always expand any category to see the full list of transactions and verify the details.

For Business Users

If you use M-Pesa for business, MpesaLens works with SME (Pochi Merchant) accounts. Mixed personal and business transactions are normal and will appear in the analysis.

Performance

Large statements covering many months may take longer to process. The app works best on Chrome, Firefox, or Safari.


Troubleshooting

PDF won't upload❔

Verify you're using an official M-Pesa statement from Safaricom and that your password is correct.

Unexpected categories❔

Expand the category sections to view all transaction details. M-Pesa transaction descriptions can be inconsistent.

Missing transactions❔

Some older statement formats may not be fully recognized. Check the expandable sections to see what was processed.


Disclaimer

MpesaLens is for personal financial analysis. Always verify important financial information against your official M-Pesa records. Users are responsible for data security and compliance with local data protection regulations.

MpesaLens is an independent tool and is not affiliated with Safaricom or M-Pesa.


Open MpesaLens

About

MpesaLens analyzes your M-Pesa PDF statements and shows you exactly how and where you've spent your money. Filter by date, search by merchant or person, and discover your spending patterns.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages