# [ExpenseLM](https://expenselm.ai) MCP Server

## Introduction

MCP server for [ExpenseLM](https://expenselm.ai).

ExpenseLM is an easy to use, GenAI powered Expense Management application. From expense recording to expense insights and advice, ExpenseLM puts you in control of your money like never before. MCP server enables access to your expense data with your favorite AI Agent.

mcp-name: io.github.clarenceh/expenselm-mcp-server

## Installation

### Prerequisites

* uv
* Python 3.9+
* ExpenseLM API key ([Instructions](https://www.expenselm.ai/docs/mcp-server-guide))

## Setup MCP Client

### Claude Desktop (Mac)

Add the following MCP server in your Claude Desktop configuration.

Config file (create if not exists): ~/Library/Application Support/Claude/claude_desktop_config.json

Add the following into your config file (replace the value of EXPENSELM_API_KEY with your own key).

```json
{
  "mcpServers": {
    "expenselm": {
      "command": "uvx",
      "args": [
        "expenselm-mcp-server"
      ],
      "env": {
        "EXPENSELM_API_KEY": "Replace with your ExpenseLM API Key",
        "MCP_TIMEOUT": "200000"
      }
    }
  }
}
```

### Claude Desktop (Windows)

Add the following MCP server in your Claude Desktop configuration.

Config file (create if not exists): %AppData%\Claude\claude_desktop_config.json (e.g. C:\Users\[YourUsername]\AppData\Roaming\Claude\claude_desktop_config.json)

Add the following into your config file (replace the value of EXPENSELM_API_KEY with your own key).

```json
{
  "mcpServers": {
    "expenselm": {
      "command": "uv",
      "args": [
        "tool",
        "run",
        "expenselm-mcp-server"
      ],
      "env": {
        "EXPENSELM_API_KEY": "Replace with your ExpenseLM API Key",
        "MCP_TIMEOUT": "200000"
      }
    }
  }
}
```

### Perplexity Desktop (Mac)

* In Perplexity Desktop for Mac, navigate to "Settings" -> "Connectors". Click "Add Connector".
* Enter ExpenseLM MCP Server configuration like the below screenshot. Replace the environment variable "EXPENSELM_API_KEY" with your own key.

![Perplexity setup](images/perplexity-mcp-config.png)

## Publish new version

* [PyPI package](PYPI.md)
* [MCP Server Registry](MCP_SERVER.md)