Skip to main content
Glama
MOKSH0077

Remote MCP Server - Expense Tracker

by MOKSH0077
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python

🧾 Remote MCP Server — Expense Tracker

A Remote MCP Server built with FastMCP that lets you track expenses directly through Claude AI — from any device, anywhere in the world. Just connect and use!

🔗 Live Server URL: https://remote-mcp-server-expense-tracker-k4gb.onrender.com/mcp

⚡ How to Connect (Any Device, Anyone)

This server uses Google OAuth — so you just need a Gmail account. No JSON files, no API keys, no technical setup!

📱 Option 1: Claude Mobile App (iPhone / Android)

  1. Open Claude App on your phone

  2. Go to Settings → Connectors (or tap the plug 🔌 icon)

  3. Tap "Add Custom Connector" or "+"

  4. Paste this URL:

    https://remote-mcp-server-expense-tracker-k4gb.onrender.com/mcp

  5. A "Sign in with Google" popup will appear

  6. Select your Gmail account → Tap Allow

  7. Done! ✅ Now just ask Claude anything about expenses!

💻 Option 2: Claude Web App (Browser — claude.ai)

  1. Go to claude.ai in your browser

  2. Click the plug icon 🔌 or go to Settings → Integrations

  3. Click "Add Integration" or "Connect MCP Server"

  4. Paste this URL:

    https://remote-mcp-server-expense-tracker-k4gb.onrender.com/mcp

  5. A "Sign in with Google" popup will appear

  6. Select your Gmail → Click Allow

  7. Done! ✅

🖥️ Option 3: Claude Desktop App (Windows / Mac)

  1. Close Claude Desktop App completely (including from system tray)

  2. Open this file in Notepad / VS Code:

    • Windows: C:\Users\<YourName>\AppData\Roaming\Claude\claude_desktop_config.json

    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

  3. Paste this config:

    {
  "mcpServers": {
    "expense-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://remote-mcp-server-expense-tracker-k4gb.onrender.com/mcp"
      ]
    }
  }
}

  4. Save the file → Reopen Claude Desktop

  5. A Google login popup will appear in your browser

  6. Sign in → Done! ✅

Note: npx requires Node.js to be installed. If you have Python/uv installed, replace "command": "npx" with "command": "uvx" and "args": ["-y", "mcp-remote", "URL"] with "args": ["fastmcp", "run", "URL"].

💬 How to Use (Ask Claude Anything!)

Once connected, just chat naturally with Claude:

What you want

What to say

Add expense

"Add ₹500 for groceries on 27 July"

View all expenses

"Show me all my expenses"

Edit an expense

"Edit expense ID 3, change amount to ₹200"

Delete an expense

"Delete expense ID 5"

🛠️ Tools Available

Tool

Description

add_expense

Add a new expense (amount, category, date, description)

list_expenses

View all your recorded expenses

edit_expense

Update an existing expense by ID

delete_expense

Remove an expense by ID

⚠️ Important Notes

  • First connection may take 30-60 seconds — Render's free tier "sleeps" after inactivity. After the first request wakes it up, everything is fast!

  • After reconnecting Google OAuth, you don't need to reconnect — Even if the server redeploys, your Google token stays saved in Claude. Just keep using it!

  • Data resets on server restart — Expenses are stored in /tmp/Expense.db on the cloud server. This is demo/learning storage. For permanent data, a cloud database (PostgreSQL/Supabase) would be needed.

  • Google account required — Any Gmail account works. No GitHub, no API keys, no technical knowledge needed!

🚀 Deploy Your Own Copy (Optional)

Want to host your own instance? Fork this repo and follow these steps.

Step 1 — Google Cloud Console (Free OAuth App)

  1. Go to console.cloud.google.com

  2. Create a new project → APIs & Services → Credentials

  3. Click "Create Credentials" → "OAuth 2.0 Client ID"

  4. Application type: Web Application

  5. Add Authorized redirect URI:

    https://YOUR-RENDER-URL.onrender.com/auth/callback

  6. Copy your Client ID and Client Secret

Step 2 — Deploy to Render.com (Free)

  1. Go to render.com → New → Web Service

  2. Connect your GitHub forked repo

  3. Settings:

    • Language: Python 3

    • Build Command: pip install uv && uv sync

    • Start Command: uv run python main.py

  4. Add Environment Variables:

    Key

    Value

    GOOGLE_CLIENT_ID

    From Google Console

    GOOGLE_CLIENT_SECRET

    From Google Console

    SERVER_BASE_URL

    https://YOUR-RENDER-URL.onrender.com

  5. Click Deploy!

📁 Project Structure

├── main.py          # MCP server — async tools + Google OAuth + detailed comments
├── pyproject.toml   # Dependencies (fastmcp, aiosqlite)
├── uv.lock          # Locked dependency versions
├── render.yaml      # Render.com deployment blueprint
├── .python-version  # Python 3.12
└── .gitignore       # Excludes .venv, .db, .env files