Qiita

You can control Qiita API v2 through MCP (Model Context Protocol) using a stdio server that enumerates every function and action as MCP endpoints. This lets you automate Qiita tasks from your preferred MCP client, with token-based authentication and flexible environment configuration.

How to use

To use this MCP server, run it as a local stdio service and connect from your MCP client. You provide your access token, and then you can call any of the Qiita API v2 features through MCP functions. If you are using a separate Qiita Team instance, you can also specify a base URL so the server targets the correct workspace.

How to install

Prerequisites: you need Node.js and npm installed on your system.

2. Install and run the MCP server using the direct, explicit command shown in the configuration snippet.

# Using npx to run the MCP server for Qiita
npx -y @sunu-py-jp/qiita-mcp

Additional configuration and notes

You can configure your MCP client to pass Qiita access tokens and, if needed, the base URL for Qiita Team workspaces. The following configuration examples illustrate how to wire the MCP server into common clients.

{
  "mcpServers": {
    "qiita_mcp": {
      "command": "npx",
      "args": ["-y", "@sunu-py-jp/qiita-mcp"],
      "env": {
        "QIITA_ACCESS_TOKEN": "your_token_here"
      }
    },
    "qiita_team": {
      "command": "npx",
      "args": ["-y", "@sunu-py-jp/qiita-mcp"],
      "env": {
        "QIITA_ACCESS_TOKEN": "your_token_here",
        "QIITA_BASE_URL": "https://your-team.qiita.com"
      }
    }
  }
}

Security and access tokens

Keep your access tokens secure. Store tokens in your MCP client configuration or environment files with restricted permissions. Rotate tokens periodically and revoke tokens if they are compromised.

Troubleshooting

If you encounter authentication errors, confirm that the QIITA_ACCESS_TOKEN you provided is valid for the target Qiita workspace. For Qiita Team, verify that QIITA_BASE_URL points to the correct domain.

Notes on the available tools

The server exposes a comprehensive set of tools that map to Qiita API v2 capabilities. Use the MCP client to invoke these tools as functions, following their described behavior and parameters.

Examples of common usage patterns

• List items with search queries to retrieve articles matching criteria.

Development

If you want to build the server from source, clone the repository, install dependencies, and build the project.

License

MIT

Available tools

create_access_token

Create a new access token for authentication

delete_access_token

Invalidate an existing access token

create_team_access_token

Create a team-scoped access token

delete_team_access_token

Invalidate a team access token

get_authenticated_user

Retrieve information about the authenticated user

list_authenticated_user_items

List articles by the authenticated user

list_items

List articles with optional search queries

get_item

Retrieve an article by ID

create_item

Create a new article

update_item

Update an existing article

delete_item

Delete an article

list_user_items

List articles by a specific user

list_user_stocks

List stocks saved by a user

list_item_stockers

List users who stocked an item

stock_item

Stock an item

unstock_item

Unstock an item

import_item

Import an item (Team admins only)

list_item_comments

List comments on an article

create_comment

Post a new comment

get_comment

Retrieve a comment by ID

update_comment

Update a comment

delete_comment

Delete a comment

import_comment

Import a comment (Team admins only)

list_tags

List all tags

get_tag

Get tag details

list_tag_items

List articles with a specific tag

list_user_following_tags

List tags followed by a user

follow_tag

Follow a tag

unfollow_tag

Unfollow a tag

create_tagging

Tag an article (Team only)

delete_tagging

Remove a tag from an article (Team only)

list_users

List users

get_user

Get user information

list_user_followees

List users followed by a user

list_user_followers

List a user's followers

follow_user

Follow a user

unfollow_user

Unfollow a user

check_user_following

Check if following a user

list_item_likes

List likes on an article

check_item_stock

Check if an article is stocked by the current user

create_item_reaction

Add a reaction to an article

list_item_reactions

List reactions on an article

delete_item_reaction

Delete a reaction from an article

create_comment_reaction

Add a reaction to a comment

list_comment_reactions

List reactions on a comment

delete_comment_reaction

Delete a reaction from a comment

create_project_comment_reaction

Add a reaction to a project comment