🧾 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"].

Related MCP server: expense-tracker-remote-mcp-server

💬 How to Use (Ask Claude Anything!)

Once connected, just chat naturally with Claude:

🛠️ Tools Available

⚠️ 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