io.github.evan-moon/firma
Local-first portfolio tracker for overseas investors. Claude reads and writes your finances via MCP.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
firma-appclaude mcp add firma -e 'FINNHUB_API_KEY=<your finnhub_api_key>' -- npx -y firma-app@0.4.2
{
"mcpServers": {
"firma": {
"command": "npx",
"args": [
"-y",
"firma-app@0.4.2"
],
"env": {
"FINNHUB_API_KEY": "<your finnhub_api_key>"
}
}
}
}
Environment variables
FINNHUB_API_KEYsecret Finnhub API key for stock price sync and market data. Get a free key at finnhub.io. Alternatively set via: firma config set finnhub-key <key>
Frequently asked questions
What is io.github.evan-moon/firma?
Local-first portfolio tracker for overseas investors. Claude reads and writes your finances via MCP.
How do I install io.github.evan-moon/firma?
It runs on your machine. In Claude Code: claude mcp add firma -e 'FINNHUB_API_KEY=<your finnhub_api_key>' -- npx -y firma-app@0.4.2. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.evan-moon/firma need an API key?
Yes. It expects FINNHUB_API_KEY, which you set in its configuration.
Is io.github.evan-moon/firma open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains io.github.evan-moon/firma?
It is published by evan-moon. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.