---
id: graphqlclient
version: "0.2.4"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# graphqlclient — Simple GraphQL client for Python 2.7+

License: permissive · Maintenance: abandoned · Downloads: 102.4K/mo

## What it is and what it does

graphqlclient is a minimal GraphQL client that wraps HTTP requests to GraphQL endpoints. It provides a single GraphQLClient class that accepts a GraphQL endpoint URL, executes queries as strings, and returns the server's response. The package supports injecting authorization tokens into request headers, either using the default 'Authorization' header or a custom header name like 'x-api-key'.

The package is intentionally simple: it has no runtime dependencies and does not provide query builders, type safety, or advanced features. It is designed for straightforward use cases where you need to send raw GraphQL query strings to an endpoint and handle the JSON response directly in your code.

Use it for:

- Send simple GraphQL queries to a public or internal GraphQL API endpoint for data retrieval
- Integrate GraphQL API calls into a Python script with minimal setup
- Add bearer token or API key authentication to GraphQL requests via custom headers
- Prototype or test a GraphQL endpoint without installing a full-featured client library

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A lightweight GraphQL client that sends queries to GraphQL endpoints and returns results, with support for custom authorization headers.

No. The package is abandoned (last release 2018-07-12, no commits since 2020-09-30) and specifies only Python 2.7+ compatibility with no upper bound, raising serious questions about compatibility with modern Python versions. High install friction combined with lack of maintenance makes this a poor choice for new projects.

## Install

pip install graphqlclient
uv add graphqlclient
poetry add graphqlclient

## Installing graphqlclient

Before you install: High install friction and abandoned maintenance status: last release was 2018-07-12, over 2955 days ago, with no recent commits. The package has no runtime dependencies but has not been updated to address Python version changes.

License in practice: MIT license is permissive and poses no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install graphqlclient

from graphqlclient import GraphQLClient

client = GraphQLClient('http://graphql-swapi.parseapp.com/')
result = client.execute('{ allFilms { films { title } } }')
print(result)

Package specifies Python 2.7+ with no upper bound; compatibility with modern Python versions is unverified.

Verify before relying:

- Whether the package works with current Python versions (support specified only as '2.7+' with no upper bound)
- Whether the package is compatible with modern GraphQL servers and query formats
- Whether the simple HTTP-based approach handles advanced GraphQL features

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: abandoned
- Downloads: 102.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

graphql client python, query graphql api, graphql http requests, graphql authorization token, simple graphql queries, graphql, http-client, abandoned

[View on SkillFed](https://skillfed.io/packages/graphqlclient) · [View on PyPI](https://pypi.org/project/graphqlclient/)