langchain-taiga

This package provides Taiga tools and a toolkit for use with LangChain. It includes:

create_entity_tool: Creates user stories, tasks and issues in Taiga.
search_entities_tool: Searches for user stories, tasks and issues in Taiga.
get_entity_by_ref_tool: Gets a user story, task or issue by reference.
update_entity_by_ref_tool: Updates a user story, task or issue by reference.
add_comment_by_ref_tool: Adds a comment to a user story, task or issue.
add_attachment_by_ref_tool: Adds an attachment to a user story, task or issue.

Installation

pip install -U langchain-taiga

Environment Variable

Export your taiga logins:

export TAIGA_URL="https://taiga.xyz.org/"
export TAIGA_API_URL="https://taiga.xyz.org/"
export TAIGA_USERNAME="username"
export TAIGA_PASSWORD="pw"
export OPENAI_API_KEY="OPENAI_API_KEY"

If this environment variable is not set, the tools will raise a ValueError when instantiated.

Usage

Direct Tool Usage

from langchain_taiga.tools.taiga_tools import create_entity_tool, search_entities_tool, get_entity_by_ref_tool, update_entity_by_ref_tool, add_comment_by_ref_tool, add_attachment_by_ref_tool

response = create_entity_tool({"project_slug": "slug",
                       "entity_type": "us",
                       "subject": "subject",
                       "status": "new",
                       "description": "desc",
                       "parent_ref": 5,
                       "assign_to": "user",
                       "due_date": "2022-01-01",
                       "tags": ["tag1", "tag2"]})

response = search_entities_tool({"project_slug": "slug", "query": "query", "entity_type": "task"})

response = get_entity_by_ref_tool({"entity_type": "user_story", "project_id": 1, "ref": "1"})

response = update_entity_by_ref_tool({"project_slug": "slug", "entity_ref": 555, "entity_type": "us"})

response = add_comment_by_ref_tool({"project_slug": "slug", "entity_ref": 3, "entity_type": "us",
                "comment": "new"})

response = add_attachment_by_ref_tool({"project_slug": "slug", "entity_ref": 3, "entity_type": "us",
                "attachment_url": "url", "content_type": "png", "description": "desc"})

Using the Toolkit

You can also use TaigaToolkit to automatically gather both tools:

from langchain_taiga.toolkits import TaigaToolkit

toolkit = TaigaToolkit()
tools = toolkit.get_tools()

MCP server (Claude CLI & GitHub Copilot Chat)

The package now ships with a Model Context Protocol server powered by fastmcp. It exposes the same Taiga tools without changing their behaviour.

Ensure the Taiga environment variables above are set for the process running the server.
Start the server:
```
python -m langchain_taiga.mcp_server
```
Point your MCP client at the command:
- Claude CLI/Desktop: add to ~/.config/claude/claude.json under "mcpServers":
```
{
  "mcpServers": {
    "taiga": {
      "command": "python",
      "args": ["-m", "langchain_taiga.mcp_server"]
    }
  }
}
```
- GitHub Copilot Chat (CLI/IDE): add a similar entry to your Copilot MCP configuration, pointing to python -m langchain_taiga.mcp_server so the client can discover the Taiga tools.

The server exports the following tools for MCP clients: create_entity_tool, search_entities_tool, get_entity_by_ref_tool, update_entity_by_ref_tool, add_comment_by_ref_tool, and add_attachment_by_ref_tool.

Tests

If you have a tests folder (e.g. tests/unit_tests/), you can run them (assuming Pytest) with:

pytest --maxfail=1 --disable-warnings -q

License

MIT License

Further Documentation

For more details, see the docstrings in:
- taiga_tools.py
- toolkits.py for TaigaToolkit
Official Taiga Developer Docs: https://docs.taiga.io/api.html
LangChain GitHub for general LangChain usage and tooling.

Metadata

Release files for langchain-taiga 1.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for langchain-taiga 1.6.0
File	Size	Uploaded
langchain_taiga-1.6.0.tar.gz	21.3 kB	Feb 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for langchain-taiga 1.6.0
File	Interpreter	ABI	Platform	Reset
langchain_taiga-1.6.0-py3-none-any.whl 21.9 kB Feb 7, 2026	Python 3	none	any	Details

Total release size: 43.1 kB

Release files / langchain_taiga-1.6.0.tar.gz

Download URL	langchain_taiga-1.6.0.tar.gz
Size	21.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`663fcc429e1d772c7e84b8c1f77b68bca8f0efb352654da4c510364818b91805`
BLAKE2b-256 checksum How to use checksums	`8a04732fe4d6823e93c8e913902348cba6790c52f55f41629347e81d67ed1ec5`
Upload date	Feb 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Shikenso-Analytics/langchain-taiga
Publishing commit: github.com/Shikenso-Analytics/langchain-taiga/tree/0a3ebadd53463881f1772c2eff7059e4a9e28243

Workflow

Publishing configuration: github.com/Shikenso-Analytics/langchain-taiga/blob/0a3ebadd53463881f1772c2eff7059e4a9e28243/.github/workflows/ci_publish.yml
Publishing logs: github.com/Shikenso-Analytics/langchain-taiga/actions/runs/21776967384/attempts/1

Artifact

Subject: langchain_taiga-1.6.0.tar.gz
SHA-256 checksum: 663fcc429e1d772c7e84b8c1f77b68bca8f0efb352654da4c510364818b91805 Verifying attestations

Release files / langchain_taiga-1.6.0-py3-none-any.whl

Download URL	langchain_taiga-1.6.0-py3-none-any.whl
Size	21.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`53b1e1ea8ab3609facaebd710e9d135b667d4d3cc8c702b1d45d0a6199ac437d`
BLAKE2b-256 checksum How to use checksums	`f29b1576068743b722286df0a257d23f870b6bc4d8562bec3260aca9ff7cd167`
Upload date	Feb 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.7`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Shikenso-Analytics/langchain-taiga
Publishing commit: github.com/Shikenso-Analytics/langchain-taiga/tree/0a3ebadd53463881f1772c2eff7059e4a9e28243

Workflow

Publishing configuration: github.com/Shikenso-Analytics/langchain-taiga/blob/0a3ebadd53463881f1772c2eff7059e4a9e28243/.github/workflows/ci_publish.yml
Publishing logs: github.com/Shikenso-Analytics/langchain-taiga/actions/runs/21776967384/attempts/1

Artifact

Subject: langchain_taiga-1.6.0-py3-none-any.whl
SHA-256 checksum: 53b1e1ea8ab3609facaebd710e9d135b667d4d3cc8c702b1d45d0a6199ac437d Verifying attestations