Skip to main content

A MCP server for interacting with the Nutritionix API via Model Context Protocol tools

Project description

🥦 Nutritionix MCP Server

This is an MCP (Model Context Protocol) server for integrating with the Nutritionix API, enabling AI agents to access food search, nutrition data, and exercise calorie estimates via natural language input.

The goal of this project is to expose Nutritionix's functionality through MCP-compatible tools that can be used seamlessly by large language models and agent frameworks.


🧠 What is MCP?

MCP (Model Context Protocol) is a lightweight protocol designed to let AI agents interact with external tools and APIs in a structured and modular way. Think of it like USB for AI — this server acts as a "driver" for the Nutritionix platform.

With this MCP server, AI models can:

  • 🔍 Search for common and branded food items
  • 🍽️ Parse natural language meals into nutritional breakdowns
  • 🏃 Estimate calories burned from exercises like running, cycling, or yoga

🚀 How to Run

To use this MCP server, you'll need:

✅ Prerequisites

  • Python 3.11+
  • uv – a modern Python package manager
  • A supported LLM (e.g., Claude)
  • A Nutritionix API App ID and App Key – get them at developer.nutritionix.com

Add this to Claude Desktop config

{
  "mcpServers": {
    "nutritionix-mcp": {
      "command": "uvx",
      "args": [
        "nutritionix-mcp-server",
        "--app-id",
        "YOUR APP ID",
        "--app-key",
        "YOUR APP KEY"
      ]
    }
  }
}

🤝 Contributions Welcome!

Whether you're into nutrition tech, AI agent development, or API tooling — we’d love your help improving this project. You can contribute by:

  • Adding new tools (e.g., barcode search, food logging)
  • Improving response formatting
  • Writing tests or documentation
  • Suggesting new ideas via Issues or Discussions

Feel free to fork, explore, and submit a PR. Let’s make agent-integrated nutrition smarter, together. 🧠🥗


MCP-FORGE – Building tools for the future of intelligent automation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nutritionix_mcp_server-0.1.1.tar.gz (20.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nutritionix_mcp_server-0.1.1-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

File details

Details for the file nutritionix_mcp_server-0.1.1.tar.gz.

File metadata

File hashes

Hashes for nutritionix_mcp_server-0.1.1.tar.gz
Algorithm Hash digest
SHA256 c0ef0f41e6473697db1317ad76fc2cf490aa0a9f421c5d5bfe2d5dc64ad8b8cc
MD5 210c21b6d49da1dfc39a9f447685b2ad
BLAKE2b-256 381da33e1fb4070aec28f0c58dbb1b8e43c82b2999781cd7937a957ffe7b7161

See more details on using hashes here.

File details

Details for the file nutritionix_mcp_server-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for nutritionix_mcp_server-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0106b8305225298591e2799319925c606086f33f7231457f4702130e08e6669b
MD5 c41006f4473fdec8b576988e0305f778
BLAKE2b-256 f0bee26507f7625a78b4c936e3d9c93e74cbfdfe19a9f8789344fddf44414b0f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page