mcpField
I
issueport

issueport

Local
github.com/CloudCorpRecordsProductivity0Updated 2w ago
Repository

About issueport

issueport is a GraphQL client and stdio MCP server for a core subset of Linear's teams, projects, issues, and comments operations. It is for users connecting to Linear with an API key, offering 12 tools without reproducing the hosted OAuth service.

Key features

  1. 01List and retrieve teams and projects
  2. 02Create projects and issues
  3. 03Search and update issues
  4. 04Archive issues
  5. 05List and create comments

Use cases

  1. 01Search for a Linear issue
  2. 02Create or update an issue
  3. 03Review or add issue comments

MCP support

The stdio MCP server exposes 12 tools for Linear teams, projects, issues, and comments. Calls use the Linear GraphQL API and require `LINEAR_API_KEY`.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "cloudcorprecords-issueport": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/issueport"
      ]
    }
  }
}
Run commandnpx -y @reneturcios/issueport

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@reneturcios/issueport0.1.0
ocighcr.io/cloudcorprecords/issueport:0.1.0

Tools

12

Saved tool list · updated 1w ago

ParameterTypeRequiredDescription
limitnumberNoMaximum number of issues to return; defaults to 50 when omitted.
team_idstringNoId of the Linear team to restrict the listed issues to; when omitted, issues from all teams are listed.

Details

From the project README

issueport

Linear teams, projects, issues and comments as MCP tools, talking to the Linear GraphQL API. issueport is a clean-room rebuild of the core subset of the Linear MCP surface, under a new name: fresh code written from Linear's public API documentation, no copied branding. The original Linear server is hosted/remote with OAuth; this rebuild is a GraphQL client for the same upstream API using an API key, and does not reproduce the hosted OAuth surface.

Tools (core subset, 12)

list_issues, get_issue, create_issue, update_issue, search_issues, list_teams, get_team, list_projects, create_project, list_comments, create_comment, archive_issue.

Not in this subset: cycles, documents, file uploads, webhooks, OAuth apps, time tracking, triage/custom workflows admin, project milestones/labels management, attachments, notifications.

Each tool is one GraphQL operation (query or mutation) posted as {query, variables}; a GraphQL errors array fails the call with the first error's message.

Setup

export LINEAR_API_KEY=lin_api_...

Note: Linear API keys are sent raw as the Authorization header value — not as a Bearer token. Optionally override the endpoint with LINEAR_API_URL (default https://api.linear.app/graphql). Without the key, every tool call fails with an error naming the missing variable.

CLI

npx @reneturcios/issueport get_issue '{"issue_id":"..."}'
npx @reneturcios/issueport mcp        # stdio MCP server

Each tool name is a subcommand taking one JSON object argument.

MCP client config

{
  "mcpServers": {
    "issueport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/issueport", "mcp"],
      "env": { "LINEAR_API_KEY": "lin_api_..." }
    }
  }
}

Docker

docker run -i -e LINEAR_API_KEY ghcr.io/cloudcorprecords/issueport

Development

npm install
npm run build
npm test

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.