Taiga Mcp Server

import { TaigaClient } from "taiga-api-client";
// baseUrl is the only required option.const client = new TaigaClient({ baseUrl: "https://api.taiga.io" });
// Log in (the `username` field accepts both username and email).await client.auth.login({ username: "[email protected]", password: "secret" });
// Fetch projects you are a member of.const me = await client.users.me();const projects = await client.projects.list({ member: me.id });
// Create a user story.const story = await client.userStories.create({  project: projects[0].id,  subject: "Add OAuth login",  description: "Support GitHub OAuth in addition to password login",});
// Iterate over every issue in the project (auto-pagination).for await (const issue of client.issues.paginate({ project: projects[0].id })) {  console.log(`#${issue.ref} ${issue.subject}`);}

const data = await client.issues.filtersData({ project: 42 });const inProgress = (data.statuses as Array<{ id: number; name: string }>)  .find((s) => s.name === "In progress");
await client.issues.create({ project: 42, subject: "...", status: inProgress!.id });

const client = new TaigaClient({ baseUrl: "https://api.taiga.io" });

const client = new TaigaClient({  baseUrl: "https://api.taiga.io", // ← required
  // Authentication — pick one (or none, if you will call client.auth.login later):  token: "...", // a previously obtained bearer token (session restore)  refreshToken: "...", // its paired refresh token  applicationToken: "...", // a static Application token, used instead of bearer
  // Behavior:  autoRefresh: true, // auto-refresh the bearer token on 401 (default true)  timeoutMs: 30000, // request timeout in ms (default 30000)  userAgent: "my-app/1.0",  acceptLanguage: "en",  apiPrefix: "/api/v1", // change only for self-hosted with a non-default prefix  fetch: customFetch, // dependency-injected fetch (proxies, mocks)
  // Token persistence hook:  onTokenChange: async (tokens) => {    if (tokens) await db.saveTokens(tokens);    else await db.clearTokens();  },});

const client = new TaigaClient({  baseUrl: "https://api.taiga.io",  token: await db.loadToken(),  refreshToken: await db.loadRefreshToken(),  onTokenChange: async (tokens) => {    if (tokens) await db.saveTokens(tokens);    else await db.clearTokens();  },});

const auth = await client.auth.login({ username: "u", password: "p" });console.log(auth.auth_token, auth.refresh, auth.full_name);

const me = await client.users.me();await client.users.updateMe({ bio: "TypeScript fan", lang: "en" });await client.users.changePassword("oldPwd!", "newPwd!");

const proj = await client.projects.create({ name: "Demo", description: "" });const sameProj = await client.projects.getBySlug(proj.slug);const updated = await client.projects.patch(proj.id, { description: "Updated" }, /* version */ 1);const stats = await client.projects.stats(proj.id);await client.projects.delete(proj.id);

await client.memberships.bulkCreate({  project_id: proj.id,  bulk_memberships: [    { role_id: 1, username: "[email protected]" },    { role_id: 2, username: "[email protected]" },  ],  invitation_extra_text: "Welcome to the team",});

const story = await client.userStories.create({  project: proj.id,  subject: "User can log in via GitHub",  description: "OAuth flow",});
// Bulk create from a multi-line string (the way the Taiga UI does it):await client.userStories.bulkCreate({  project_id: proj.id,  bulk_stories: "Story 1\nStory 2\nStory 3",});
// Iterate over every story in the project:for await (const s of client.userStories.paginate({ project: proj.id })) {  console.log(s.subject);}

const task = await client.tasks.create({  project: proj.id,  subject: "Implement OAuth callback",  user_story: story.id, // link to a user story});

const issue = await client.issues.create({  project: proj.id,  subject: "Login button doesn't work in Safari",  description: "Reproduces on macOS Safari 17.x",});await client.issues.upvote(issue.id);await client.issues.watch(issue.id);

const epic = await client.epics.create({  project: proj.id,  subject: "Q1 roadmap",  color: "#ff8800",});await client.epics.addRelatedUserStory(epic.id, { user_story: story.id });for (const link of await client.epics.relatedUserStories(epic.id)) {  console.log(link.user_story);}

const sprint = await client.milestones.create({  project: proj.id,  name: "Sprint 1",  estimated_start: "2026-01-01",  estimated_finish: "2026-01-14",});const burndown = await client.milestones.stats(sprint.id);

// 1. Async iterator (recommended): lazy, walks the next links.for await (const story of client.userStories.paginate({ project: 42 })) {  await processStory(story);}
// 2. A specific page plus metadata.const page = await client.userStories.listPage({ project: 42 }, 3);console.log(page.data, page.pagination); // { count, perPage, current, next, prev }
// 3. Disable pagination entirely (returns the full set as one array).const all = await client.http.get("/userstories", {  query: { project: 42 },  disablePagination: true,});

import {  TaigaApiError,  TaigaAuthError,  TaigaRateLimitError,  TaigaNetworkError,} from "taiga-api-client";
try {  await client.projects.get(99999);} catch (err) {  if (err instanceof TaigaRateLimitError) {    await sleep((err.retryAfter ?? 1) * 1000);  } else if (err instanceof TaigaAuthError) {    // Session is dead — log in again  } else if (err instanceof TaigaApiError) {    console.error(`Taiga ${err.status}: ${err.detail ?? err.message}`);  } else if (err instanceof TaigaNetworkError) {    // Network / timeout  }}

const story = await client.userStories.get(42);const updated = await client.userStories.patch(  story.id,  { subject: "Renamed" },  story.version, // ← OCC);

const result = await client.http.get<{ id: number }[]>("/wiki", {  query: { project: 1 },});console.log(result.data, result.pagination, result.headers);