Gokulnath31/groww-mcp-server

Groww MCP Server

A Python-based server implementation using FastMCP and GrowwAPI for handling MCP (Message Control Protocol) operations. This server provides a natural language interface for agentic applications to interact with Groww's services.

Overview

The Groww MCP Server enables AI-driven workflows to interact with Groww's services through a natural language interface. Using this MCP Server, you can:

• Query and manage user data
• Handle authentication and authorization
• Process financial transactions
• Access market data and analytics

Features

• Natural Language Queries: Enables AI agents to interact with Groww services using natural language
• Seamless MCP Integration: Works with any MCP client for smooth communication
• Secure Authentication: Handles user authentication and session management
• Scalable Architecture: Designed for high-performance operations
• Comprehensive API Coverage: Access to all major Groww service endpoints

Requirements

• Python >= 3.13
• FastMCP >= 2.5.2
• GrowwAPI >= 0.0.7

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/groww-mcp-server.git
   cd groww-mcp-server
   

2. Create and activate virtual environment using uv:

   uv venv
   source .venv/bin/activate  # On Unix/MacOS
   # OR
   .venv\Scripts\activate     # On Windows
   

3. Install dependencies:

   uv sync
   

Configuration

The server requires a single environment variable:

Set the environment variable before running the server:

export GROWW_API_AUTH_TOKEN="your_auth_token"

Project Structure

groww-mcp-server/
├── src/
│   ├── main.py           # Main application entry point
│   ├── env_vars.py       # Environment variables configuration
│   ├── tools/            # Utility tools and helpers
│   ├── schemas/          # Data schemas and models
│   └── services/         # Business logic and service implementations
├── pyproject.toml        # Project dependencies and metadata
└── README.md            # Project documentation

Integration

VS Code Configuration

Add the following to your VS Code settings:

{
  "mcp": {
    "servers": {
      "groww-mcp": {
        "type": "stdio",
        "command": "<full_path_uv_command>",
        "args": [
          "--directory",
          "<your_mcp_server_directory>",
          "run",
          "src/main.py"
        ],
        "env": {
          "GROWW_API_AUTH_TOKEN": "<your_auth_token>"
        }
      }
    }
  }
}

Claude Desktop Integration

Configure Claude Desktop by editing claude_desktop_config.json:

{
  "mcpServers": {
    "groww": {
      "command": "<full_path_uv_command>",
      "args": [
        "--directory",
        "<your_mcp_server_directory>",
        "run",
        "src/main.py"
      ],
      "env": {
        "GROWW_API_AUTH_TOKEN": "<your_auth_token>"
      }
    }
  }
}

Testing

Use the MCP Inspector for visual debugging:

npx @modelcontextprotocol/inspector uv run src/main.py

Example Use Cases

• Financial Data Analysis: Query and analyze market data
• User Management: Handle user authentication and profile management
• Transaction Processing: Process and verify financial transactions
• Portfolio Management: Access and manage investment portfolios

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to your branch
5. Submit a pull request

License

[Add your license information here]

Contact

For questions or support, please open an issue in the GitHub repository.