How to Connect Linear Remote MCP to OpenAI Codex CLI

Add Linear Orbit Inc.'s remote MCP server to OpenAI Codex CLI in about a minute.

๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1ยทhttps://mcp.linear.app/mcp

Step-by-step

  1. Edit ~/.codex/config.toml
    Add the [mcp_servers.linear] table shown in the connect card (TOML) to ~/.codex/config.toml โ€” Codex loads remote MCP servers at startup.
  2. Authorize
    On first use your client opens a Linear Orbit Inc. OAuth consent screen โ€” approve it and tools become available.
  3. Verify
    Restart Codex, then run codex mcp list (or ask the agent to call a tool). Verify in the browser: paste https://mcp.linear.app/mcp into remotemcp.net/inspector and run initialize + tools/list.

Troubleshooting OAuth / 401

  • A 401 Unauthorized on first connect is normal โ€” the endpoint is OAuth-protected; let OpenAI Codex CLI finish the browser consent flow.
  • If the consent window never opens, remove and re-add the server, then retry.
  • Check the exact challenge at our OAuth debugger.
  • Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.
HTTP + SSEhttps://mcp.linear.app/mcp
Legacy SSE endpoint
SSEhttps://mcp.linear.app/sse

Add to ~/.codex/config.toml โ€” Codex reads remote HTTP servers from [mcp_servers.*] tables:

[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"

Tools exposed by Linear MCP (30)

ToolSafetyDescriptionParameters
search_documentation
~34 tok
๐ŸŸข ReadSearch Linear's official documentation.โ€”
list_comments
~32 tok
๐ŸŸข ReadList comments on an issue or document.โ€”
create_comment
~30 tok
๐ŸŸ  WriteCreate a comment on an issue.โ€”
list_cycles
~28 tok
๐ŸŸข ReadList cycles of a team.โ€”
get_cycle
~27 tok
๐ŸŸข ReadGet details of a cycle.โ€”
list_documents
~28 tok
๐ŸŸข ReadList Linear documents.โ€”
get_document
~28 tok
๐ŸŸข ReadGet a Linear document.โ€”
create_document
~29 tok
๐ŸŸ  WriteCreate a Linear document.โ€”
update_document
~29 tok
๐ŸŸ  WriteUpdate a Linear document.โ€”
list_issue_labels
~28 tok
๐ŸŸข ReadList issue labels.โ€”
create_issue_label
~29 tok
๐ŸŸ  WriteCreate an issue label.โ€”
list_issue_statuses
~31 tok
๐ŸŸข ReadList issue workflow states.โ€”
get_issue_status
~31 tok
๐ŸŸข ReadGet details of a workflow state.โ€”
list_issues
~28 tok
๐ŸŸข ReadList issues with filters.โ€”
get_issue
~28 tok
๐ŸŸข ReadGet details of an issue.โ€”
get_issue_git_branch_name
~37 tok
๐ŸŸข ReadGet the suggested git branch name for an issue.โ€”
create_issue
~28 tok
๐ŸŸ  WriteCreate a Linear issue.โ€”
update_issue
~28 tok
๐ŸŸ  WriteUpdate a Linear issue.โ€”
list_projects
~28 tok
๐ŸŸข ReadList Linear projects.โ€”
get_project
~28 tok
๐ŸŸข ReadGet details of a project.โ€”
create_project
~29 tok
๐ŸŸ  WriteCreate a Linear project.โ€”
update_project
~29 tok
๐ŸŸ  WriteUpdate a Linear project.โ€”
list_project_labels
~29 tok
๐ŸŸข ReadList project labels.โ€”
list_project_statuses
~30 tok
๐ŸŸข ReadList project statuses.โ€”
get_project_status
~32 tok
๐ŸŸข ReadGet details of a project status.โ€”
list_teams
~29 tok
๐ŸŸข ReadList teams in the workspace.โ€”
get_team
~27 tok
๐ŸŸข ReadGet details of a team.โ€”
list_users
~29 tok
๐ŸŸข ReadList users in the workspace.โ€”
get_user
~27 tok
๐ŸŸข ReadGet details of a user.โ€”
list_initiatives
~29 tok
๐ŸŸข ReadList Linear initiatives.โ€”

Connect Linear MCP to another client

Other servers for OpenAI Codex CLI

GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.

https://api.githubcopilot.com/mcp/
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~3096 tok92 toolsOnline261ms
Notion MCPNotion Labs

Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.

https://mcp.notion.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~606 tok18 toolsOnline21ms

Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.

https://mcp.figma.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿงฉ MCP App๐Ÿ›ก๏ธ A+~286 tok8 toolsOnline218ms
AWS KnowledgeAmazon Web Services

AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ€” connect and call tools immediately.

https://knowledge-mcp.global.api.aws
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~1896 tok5 toolsOnline155ms

Stripe's official remote MCP server at mcp.stripe.com. Agents can query customers, payment intents and subscriptions and invoke Stripe API operations with OAuth.

https://mcp.stripe.com
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~1336 tok43 toolsOnline217ms
Claude SkillsClaudeSkills.club

Claude Skills's hosted remote MCP server. ClaudeSkills.club's public MCP lets agents search and pull from a catalog of 90,000+ Agent Skills (SKILL.md) โ€” workflow specs, safety scores and one-line install instructions. It is public and unauthenticated โ€” connect and call tools immediately.

https://claudeskills.club/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~344 tok3 toolsOnline125ms