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.

67 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,500+ 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 so your agent can perform Linear operations on your behalf.

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 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

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

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 issue

Create or update a Linear issue.

Save milestone

Create or update a milestone in a Linear project.

Save project

Create or update a Linear project.

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