How to integrate Linear MCP with Atomic Agent

Connect Atomic Agent to Linear MCP. List all open issues assigned to me, create a new issue from template, and more using natural language, with authentication handled for you.

Linear MCP logoLinear MCP
Dcr Oauth

Linear MCP is Linear's interface for managing issues, projects, comments, and planning objects within a workspace. It centralizes planning data and simplifies tracking, prioritization, and collaboration across teams.

78 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Linear.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Linear account. See the Atomic Agent documentation for installation instructions.

Also integrate Linear MCP with

How Atomic Agent connects to Linear

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Linear to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Linear. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Linear account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Linear MCP server, and what's possible with it?

The Linear MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Linear account. It provides structured and secure access to your workspace issues, projects, initiatives, documents, cycles, releases, and discussions, so your agent can review work, inspect plans, track updates, manage comments, and organize attachments on your behalf.

  • Issue and team tracking: Have your agent list issues, retrieve issue details, review available statuses and labels, and inspect the teams and users responsible for the work.
  • Project and initiative visibility: Let the agent retrieve projects, initiatives, milestones, cycles, status updates, and related planning documents to help you understand current priorities.
  • Comments and attachment management: Direct your agent to review comments, remove outdated comments, retrieve attachments, link uploaded files to issues, or delete attachments.
  • Release and development review: Instruct your agent to retrieve releases and release notes, list visible pull request diffs, and inspect diff details or discussion threads.
  • Workspace inbox and resources: Have your agent check Linear notifications, list available templates and agent skills, or retrieve details about the connected workspace.

Use Linear from Atomic Agent

With your account connected, ask Atomic Agent to work with Linear in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Linear MCP action and event your agent gets out of the box.

Create attachment

Deprecated fallback for tiny files only.

Create attachment from upload

Link an already-uploaded Linear assetUrl to an existing issue as an attachment.

Create initiative label

Create a new Linear initiative label.

Create issue label

Create a new Linear issue label.

Delete attachment

Delete an attachment by ID

Delete comment

Delete a Linear comment.

Delete customer

Delete a customer in Linear

Delete customer need

Archive a customer need in Linear

Delete diff comment

Delete a comment or persisted draft from a Linear diff

Delete status update

Delete (archive) a project or initiative status update.

Extract images

Extract and fetch images from markdown content.

Get agent skill

Retrieve a Linear Agent skill by ID, including its full markdown instructions.

Get attachment

Retrieve an attachment's content by ID.

Get diff

Exact lookup for a Linear diff.

Get diff threads

Exact lookup for diff threads and the authenticated user's drafts.

Get document

Retrieve a Linear document by ID or slug

Get initiative

Retrieve detailed information about a specific initiative in Linear

Get issue

Retrieve detailed information about an issue by ID, including attachments, git branch name, and active Triage Intelligence suggestions when the issue is in triage

Get issue status

Retrieve detailed information about an issue status in Linear by name or ID

Get milestone

Retrieve details of a specific milestone by ID or name

Get notifications

Get a page of notifications from the authenticated user's Linear inbox.

Get project

Retrieve details of a specific project in Linear

Get release

Retrieve details of a release by ID or slug.

Get release note

Retrieve release notes by ID or slug, including markdown content.

Get status updates

List or get project/initiative status updates.

Get team

Retrieve details of a specific Linear team

Get template

Retrieve a Linear template by ID or name: the content it pre-fills, the ids it applies, its sub-issues, and its form fields.

Get user

Retrieve details of a specific Linear user

Get workspace

Retrieve the connected Linear workspace

List agent skills

List Linear Agent skills available to the authenticated user.

List comments

List comments on a Linear issue, project, initiative, document, project milestone, or project/initiative status update.

List customers

List customers in the user's Linear workspace

List cycles

Retrieve cycles for a specific Linear team

List diffs

List Linear diff pull requests visible to the authenticated user

List documents

List documents in the user's Linear workspace

List initiative labels

List available initiative labels in the Linear workspace.

List initiatives

List initiatives in the user's Linear workspace

List issue labels

List available issue labels in a Linear workspace or team.

List issues

List issues in the user's Linear workspace, including active Triage Intelligence suggestions for issues in triage.

List issue statuses

List available issue statuses in a Linear team

List milestones

List all milestones in a Linear project

List project labels

List available project labels in the Linear workspace.

List projects

List projects in the user's Linear workspace

List release notes

List release notes in the workspace, optionally filtered by pipeline or covered release.

List release pipelines

List release pipelines in the workspace.

List releases

List releases in the workspace, with optional filtering by pipeline, stage, version, and text.

List teams

List teams in the user's Linear workspace

List templates

List the Linear issue, project, and document templates available to the authenticated user.

List users

Retrieve users in the Linear workspace

Mark notification

Mark a Linear inbox notification as read or unread, or snooze or unsnooze it.

Merge diff

Merge a Linear diff or add it to the repository's merge queue

Prepare attachment upload

Prepare a direct Linear file upload for an existing issue.

Resolve diff thread

Resolve or reopen a top-level comment thread on a Linear diff

Restore initiative label

Restore a retired Linear initiative label, making it available for use on initiatives again.

Restore issue label

Restore a retired Linear issue label, making it available for use on issues again.

Restore project label

Restore a retired Linear project label, making it available for use on projects again.

Retire initiative label

Retire a Linear initiative label so it cannot be applied to new initiatives.

Retire issue label

Retire a Linear issue label so it cannot be applied to new issues.

Retire project label

Retire a Linear project label so it cannot be applied to new projects.

Save comment

Create or update a comment on a Linear issue, project, initiative, document, project milestone, or project/initiative status update.

Save customer

Create or update a Linear customer.

Save customer need

Create or update a customer need (request) in Linear.

Save diff comment

Create, reply to, or edit a comment or persisted draft on a Linear diff.

Save document

Create or update a Linear document.

Save initiative

Create or update a Linear initiative.

Save initiative label

Create or update a Linear initiative label.

Save issue

Create or update a Linear issue.

Save issue label

Create or update a Linear issue label.

Save milestone

Create or update a milestone in a Linear project.

Save project

Create or update a Linear project.

Save project label

Create or update a Linear project label.

Save release

Create or update a release.

Save release note

Create or update release notes.

Save status update

Create or update a project/initiative status update.

Search documentation

Search Linear's documentation to learn about features and usage

Share issue

Share an issue with a workspace user who cannot otherwise access it.

Submit diff review

Approve a Linear diff, request changes, or submit a review comment

Unshare issue

Remove a workspace user's shared access to an issue.

FAQ

Frequently asked questions

With a standalone Linear MCP server, the agents and LLMs can only access a fixed set of Linear tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Linear and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Linear tools.

Yes, absolutely. You can configure which Linear scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Linear data and credentials are handled as safely as possible.

Start with Linear MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Linear MCP tool your agent needs.Free to start.

Start building