NYC Budget — Claude Code MCP server: what it does, how to install
NYC Budget — an MCP server for accessing New York City budget data. It provides the agent with 14 tools to query expense funding, capital designations, and agency budgets.
no license ★ 20 updated 2026-11-16
claude mcp add --env NYC_BUDGET_PDF_DATA=<NYC_BUDGET_PDF_DATA> --env NYC_BUDGET_PDF_DATA_URL=<NYC_BUDGET_PDF_DATA_URL> --env NYC_BUDGET_DATA_DIR=<NYC_BUDGET_DATA_DIR> --transport stdio mcp -- npx -y @betanyc/nyc-budget-mcpWhat NYC Budget does
The server connects your AI agent to structured financial data from New York City. It processes expense reports, capital plans, and open data sources, allowing for queries across budget lines, agencies, and fiscal years.
A prebuilt SQLite index is included in the package, so no manual database cloning or building is required. To access additional PDF-derived tables, you can enable them by setting the NYC_BUDGET_PDF_DATA environment variable.
What it helps with
- retrieve NYC capital designation data
- compare adopted and modified agency budgets
- fetch expense information by budget line
- query historical changes in budget data
Example prompts for the agent
- Find capital designations for the project by budget line.
- Compare the adopted agency budget for 2024 against the modified version.
- What has changed in the expense data for the latest reporting period?
How to install NYC Budget
Platform CLI
claude mcp add --env NYC_BUDGET_PDF_DATA=<NYC_BUDGET_PDF_DATA> --env NYC_BUDGET_PDF_DATA_URL=<NYC_BUDGET_PDF_DATA_URL> --env NYC_BUDGET_DATA_DIR=<NYC_BUDGET_DATA_DIR> --transport stdio mcp -- npx -y @betanyc/nyc-budget-mcpReplace <…> with your own values
Platform CLI
codex mcp add mcp --env NYC_BUDGET_PDF_DATA=<NYC_BUDGET_PDF_DATA> --env NYC_BUDGET_PDF_DATA_URL=<NYC_BUDGET_PDF_DATA_URL> --env NYC_BUDGET_DATA_DIR=<NYC_BUDGET_DATA_DIR> -- npx -y @betanyc/nyc-budget-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@betanyc/nyc-budget-mcp"
],
"env": {
"NYC_BUDGET_PDF_DATA": "<NYC_BUDGET_PDF_DATA>",
"NYC_BUDGET_PDF_DATA_URL": "<NYC_BUDGET_PDF_DATA_URL>",
"NYC_BUDGET_DATA_DIR": "<NYC_BUDGET_DATA_DIR>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@betanyc/nyc-budget-mcp"
],
"env": {
"NYC_BUDGET_PDF_DATA": "<NYC_BUDGET_PDF_DATA>",
"NYC_BUDGET_PDF_DATA_URL": "<NYC_BUDGET_PDF_DATA_URL>",
"NYC_BUDGET_DATA_DIR": "<NYC_BUDGET_DATA_DIR>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e NYC_BUDGET_PDF_DATA=<NYC_BUDGET_PDF_DATA> -e NYC_BUDGET_PDF_DATA_URL=<NYC_BUDGET_PDF_DATA_URL> -e NYC_BUDGET_DATA_DIR=<NYC_BUDGET_DATA_DIR> mcp npx -y @betanyc/nyc-budget-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about NYC Budget
How to install NYC Budget in Claude Code?
Run claude mcp add nyc-budget-mcp -- npx -y @betanyc/nyc-budget-mcp in your project terminal.
What does NYC Budget do?
This MCP server provides your AI agent with 14 tools to query and analyze NYC budget data, including expenses, capital projects, and agency budgets.
What is required to access PDF tables?
To use the optional PDF tables, set the NYC_BUDGET_PDF_DATA environment variable to on and download the tables using npx @betanyc/nyc-budget-mcp download --pdf-tables.