Bunpro MCPUNOFFICIAL COMMUNITY TOOL Connect to ChatGPT
Unofficial community tool · read only

Your Japanese study data, ready to talk.

Ask ChatGPT about your Bunpro reviews, schedule, JLPT progress, and study habits. It can read your study data, but it can never change your account.

Set up in ChatGPT See what you can ask

No extra account. Nothing saved. Nothing changed.

今日の学習THIS WEEK
YOU

How is my study rhythm this week?

BUNPRO MCP

You studied on 5 of the past 7 days and completed 184 reviews.

From your Bunpro dataRead only
今YOUR DATA
IN CONTEXT
Your token stays protectedIt is handled like a password.
Completely read onlyIt cannot change anything in Bunpro.
Nothing is storedNo extra account or saved study history.
Made for useful questionsReviews, progress, plans, and trends.
What it is for

Less dashboard reading.
More useful reflection.

Connect Bunpro once, then ask about your studies in everyday language. ChatGPT works out which information it needs and explains the answer clearly.

01

Plan what is next

See reviews due now, scan the current forecast, and decide when to make time for Bunpro.

02

Understand your rhythm

Compare study days, review volume, new content and accuracy without manually reading charts.

03

See the bigger picture

Ask about JLPT progress, deck goals and account totals in plain language.

The simple version

How does it work?

MCP is simply the connection that lets ChatGPT ask Bunpro for the study information needed to answer your question.

You set up the connection once in ChatGPT. After that, you can ask questions naturally—there is nothing new to install inside Bunpro.

1You ask“How consistent was I?”
2ChatGPT checksThe Bunpro data it needs
3You get an answerGrounded in your study data
Manual setup · about 3 minutes

Connect it to ChatGPT

This is a community-made connection, so it is not available in ChatGPT's official directory. Follow the steps below and enter the provided details yourself.

  1. 01

    Copy your Bunpro Account API Token

    Open Bunpro → Settings → API and copy your Account API Token. Treat it like a password: do not paste it into a chat message, prompt, screenshot, URL, or support post.

  2. 02

    Enable Developer mode in ChatGPT

    Open ChatGPT Settings and turn on Developer mode. It is usually under Security and login, although its location may vary by app or workspace.

  3. 03

    Open the custom MCP screen

    Go to the ChatGPT Plugins page, select the + button, then choose the option to create a custom MCP connection.

    Open ChatGPT Plugins
  4. 04

    Enter the connection details

    Copy the exact values shown in the form preview. Leave the Bearer token env var field empty.

  5. 05

    Save and test it

    Save the connection, start a new chat with Bunpro MCP enabled, and ask

Custom MCP connectionEXACT VALUES
Bunpro MCP
Read-only Bunpro study activity, reviews, schedule, decks, progress, and trends.
Streamable HTTP ⌄
https://bunpro.yashkadam.com/mcp
Leave blank
SECRET
X-Bunpro-Token
Paste your Bunpro Account API Token
Your token is entered only once
Open source

Use the hosted service—
or run your own.

Bunpro MCP is available under the MIT license. You can inspect the implementation, run it locally over stdio, or deploy your own stateless Streamable HTTP server.

LOCAL

Run with stdio

Clone the repository, build it with Node.js 20 or newer, and keep the Account API Token in your MCP client's secret environment configuration.

REMOTE

Deploy with Docker

Use the included Dockerfile on Railway or another HTTPS host. Every caller supplies their own token; the deployment needs no database or shared Bunpro credential.

TRANSPARENT

Review before you trust

Read the source, privacy boundary, and operational limits before connecting an account or operating a public instance.

What you can ask

Eight ways to understand
your learning.

From today's workload to long-term JLPT progress, each tool answers a familiar study question without changing your Bunpro account.

READ ONLY
01 · get_connection_status

Connection check

Make sure ChatGPT can connect to your Bunpro account.

READ ONLY
02 · get_study_day_summary

Study day

See what you studied on a particular day.

READ ONLY
03 · get_study_range_summary

Study range

Look back across a week, month, or any period up to 93 days.

READ ONLY
04 · get_review_schedule

Review schedule

See what is due now and how busy the next few days look.

READ ONLY
05 · list_study_decks

Study decks

Check your active decks, daily goals, and progress.

READ ONLY
06 · get_recent_activity

Recent activity

Catch up on what you have reviewed recently.

READ ONLY
07 · get_learning_progress

Learning progress

See your overall progress from JLPT N5 through N1.

READ ONLY
08 · get_activity_trend

Activity trend

See how your reviews, new lessons, and accuracy change over time.

It cannot submit answers, start lessons, change your review level, edit decks, or update account settings.

Try asking

Good questions make the data useful.

Start with one of these after your connection test passes. Every card is copyable.

Privacy and trust

Your token is used to answer—then forgotten.

There is no extra account and your token or study history is not saved by this service. ChatGPT sends the protected token only when it asks Bunpro a question for you.

ChatGPTKeeps your token protected
Secure requestSends it with your question
Bunpro MCPPasses the request along
BunproReturns your study data

What it does

  • Uses an encrypted connection
  • Uses your token only for your request
  • Returns only the study data needed
  • Stops safely if Bunpro cannot be reached

What it does not do

  • Store tokens, sessions, or study history
  • Send your token to the language model
  • Retry aggressively after Bunpro rate limiting
  • Modify reviews, lessons, progress, decks, or settings

Who you are trusting

As with any hosted service, the service owner and hosting provider could technically see data while a request is being handled. If that trust boundary is not acceptable to you, run Bunpro MCP locally or deploy your own instance from the open-source repository.

Know before you connect

Useful, careful,
and experimental.

01

Unofficial community project

This MCP is not affiliated with or endorsed by Bunpro or OpenAI, and it is not an official ChatGPT plugin listing.

02

Bunpro access can change

This uses Bunpro's experimental Account API Token. Bunpro may change or limit what the connection can access.

03

Missing does not always mean zero

Bunpro does not provide the same amount of history for every feature. When information is missing, the answer will say so instead of assuming you did nothing.

04

Kept deliberately lightweight

You can look back up to 93 days at a time. If Bunpro asks the service to slow down, it waits for you to try again rather than repeatedly sending requests.

Troubleshooting

If setup does not work,
start here.

Most problems are fixed by checking Developer mode, your Bunpro token, or the saved connection details.

I cannot see the + or custom MCP option

Confirm Developer mode is enabled. Custom MCP creation can depend on your ChatGPT plan, app version, workspace policy, and administrator approval.

ChatGPT says a token is required

Check the header name is exactly X-Bunpro-Token. Paste the raw Account API Token as its protected value, leave the Bearer env-var field blank, and do not use both auth methods.

The connection used to work

Confirm the Bunpro token is still current. Remove or disable stale Bunpro connections, recreate this one with the current URL and protected header, then test from a new chat.

A day looks empty or incomplete

Ask ChatGPT to show coverage. A missing source record means the source did not provide evidence for that date; it does not automatically prove zero activity.

Bunpro asked me to slow down

Wait a little before trying again. Bunpro MCP will not keep retrying in the background.

I need to verify the service itself

Open the public health check. It confirms the hosted process is reachable, but it does not test or expose your Bunpro token.

Open health check
Questions, answered

The details that matter.

Clear expectations make experimental tools safer to use.

Is this an official Bunpro or OpenAI plugin?

No. It is an unofficial community MCP, is not affiliated with or endorsed by Bunpro or OpenAI, and is not published as an official ChatGPT plugin listing.

Can a link install it or prefill the ChatGPT form?

No supported deep link currently pre-populates the custom MCP creation form. The ChatGPT Plugins URL can take you to the area, but you must enter and review the connection values yourself.

Can it change anything in Bunpro?

No. All eight published tools are read only. The server does not start or submit reviews, change SRS state, add lessons, run crams, edit decks, or modify account settings.

Does the website receive my token?

No. This page is static and contains no token field. You paste the token only into your MCP client's protected credential configuration—not into this website or a chat message.

Does the server store my data?

No. This service has no account or saved study-history database. It uses your token and Bunpro data only while answering the current request.

Is the source code public?

Yes. Bunpro MCP is open source under the MIT license. You can inspect, fork, and contribute to it on GitHub .

Can I run it myself?

Yes. Run it locally over stdio or deploy the included Docker image as a stateless Streamable HTTP service. The self-hosting guide covers local, Docker, Railway, and other HTTPS hosts.

Will it work in every ChatGPT account?

Not necessarily. Developer mode and custom MCP creation availability can depend on your plan, app version, workspace policy, and administrator. Other Streamable HTTP MCP clients may also connect.

Why are some dates marked as missing?

Bunpro does not provide the same amount of history for every feature. The answer marks missing information clearly instead of pretending it means zero activity.

What should I do if I exposed my token?

Rotate or replace the Account API Token in Bunpro, then update or recreate the protected credential in every MCP client where you configured it.

Ready when you are

Turn study history into
a better next question.

Follow the setup guide

Manual connection · protected token · read only