Linear-mcp-agent

An AI agent that helps you manage your Linear projects.

Introduction · Deploy Your Own · Tech Stack · Setting Up Locally · Contributing · License

Introduction

This is an AI agent built with Mastra, the Vercel AI SDK with Linear MCP tools to help you with project management, it uses Google Gemini gemini-1.5-pro models. The agent can create and view issues, projects, and more within Linear.

Features

• Use linear MCP tools: Use the official linear 20+ MCP tools like: (list_issues, create_issue, list_teams...).
• Extensible: Built on Mastra, allowing for new tools and capabilities to be added easily.
• Open-Source: Available under the Apache 2.0 license.

Tech Stack

• Next.js – React framework for building the user interface.
• Shadcn - The React & tailwind UI component library
• Mastra – The underlying framework for the self-operating agent.
• Vercel AI SDK – For building the AI-powered chat interface.
• Prisma - Node.js and TypeScript ORM
• Neon - Serverless postgres platform

Getting Started

To get started, you can clone the repository and install the dependencies:

git clone https://github.com/HaythemLazaar/linear-mcp-agent
cd linear-mcp-agent
pnpm install

You will need to generate an API_KEY from google AI studio, as well as a connectionString from Neon.

You will also need to set up your environment variables. Copy the .env.example file to .env and fill in the required values:

BETTER_AUTH_SECRET=
GOOGLE_GENERATIVE_AI_API_KEY=
DATABASE_URL=

After that, you have to migrate the schema:

pnpm db:migrate

Then, you can run the development server:

pnpm dev

Contributing

• Open an issue if you believe you've encountered a bug.
• Make a pull request to add new features/make quality-of-life improvements/fix bugs.

License

This project is licensed under the Apache 2.0 license.