home / mcp / qiita mcp server

Qiita MCP Server

Qiita MCP Server

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "2bo-qiita-mcp-server": {
      "command": "npx",
      "args": [
        "@2bo/qiita-mcp-server"
      ],
      "env": {
        "QIITA_API_TOKEN": "YOUR_QIITA_API_TOKEN"
      }
    }
  }
}

This MCP server lets AI agents interact with Qiita by creating, reading, and updating Qiita articles through a standardized toolset. It enables automated content management on Qiita via a consistent protocol, making it easy to integrate Qiita actions into your AI workflows.

How to use

You can use this MCP server with any MCP client to perform common Qiita actions such as listing your articles, fetching a specific article, creating new content, updating existing posts, and reviewing Markdown rules. Start the server locally or point your MCP client at its runtime endpoint to begin issuing the supported tools.

How to install

Prerequisites you need before installing and running the MCP server are a recent version of Node.js and a Qiita API access token.

# 1) Ensure Node.js is installed (v18+ or newer recommended)
node -v
npm -v

# 2) Install dependencies and build as needed
npm install
npm run build

# 3) Start the MCP server (examples may vary by project setup)
npx @2bo/qiita-mcp-server

Configuration and usage with an MCP client

To run the MCP server locally and connect it to your client, use the following configuration snippet in your client’s MCP setup. This example shows how to supply your Qiita API token and initialize the server via a standard MCP stdio entry point.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "qiita-api-token",
      "description": "Qiita API Token",
      "password": true
    }
  ],
  "servers": {
    "qiita-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["@2bo/qiita-mcp-server"],
      "env": {
        "QIITA_API_TOKEN": "${input:qiita-api-token}"
      }
    }
  }
}

Available tools

The server provides a set of MCP tools to manage Qiita content. Each tool performs a specific action against your Qiita account.

List of Qiita tools

- get_my_qiita_articles — Retrieve articles for the currently authenticated Qiita user.

- get_qiita_item — Retrieve a single Qiita article by its ID.

- post_qiita_article — Create a new article on Qiita.

- update_qiita_article — Update an existing Qiita article.

- get_qiita_markdown_rules — Retrieve the Markdown rules and cheat sheet used by Qiita.

Notes on security and tokens

Treat your Qiita API token as a sensitive credential. Do not expose it in public configurations. Use secure environment management to inject the token at runtime.

Developer notes

Development commands shown include common tasks like installing dependencies, building, and starting the server in a local development workflow. Ensure you have an active Qiita API token before starting the server.

Available tools

get_my_qiita_articles

Fetch all articles created by the currently authenticated Qiita user.

get_qiita_item

Retrieve a specific Qiita article by its Qiita ID.

post_qiita_article

Create a new article on Qiita with specified title, body, and tags.

update_qiita_article

Update attributes of an existing Qiita article, such as title, body, or tags.

get_qiita_markdown_rules

Return the Markdown syntax rules and cheat sheet used by Qiita.