Microblog Books

You can run this MCP server locally or deploy it to a hosting service to manage your Micro.blog Books data through an MCP client. It provides bookshelf and book management, plus reading goal tracking, all accessible via the MCP protocol. This guide shows practical steps to install, run, and use the server with your MCP clients.

How to use

You connect to the server from your MCP client using the HTTP transport after deployment, or use local testing via the provided runtime commands. Once connected, you can manage your Micro.blog Books data by invoking the available tools to create shelves, add or move books, update covers, and track reading goals. You can perform combined workflows, such as creating a bookshelf named Currently Reading, adding a book to it, moving books between shelves, updating covers, and checking progress toward reading goals.

How to install

Prerequisites

• A computing environment with Python and the uv runtime available
• A Micro.blog account with API access and a bearer token to authenticate requests
• Optional: an MCP client to connect via HTTP transport once the server is deployed

Install and run locally using the built-in development flow shown here. Follow these steps in order.

# Install dependencies
uv sync

# Run the server locally with HTTP transport on port 8000
export MICRO_BLOG_BEARER_TOKEN="your_token_here"
uv run fastmcp run server.py --transport http --port 8000

# Or run directly with the Python entrypoint
export MICRO_BLOG_BEARER_TOKEN="your_token_here"
uv run python server.py

Additional notes

Environment variables

• MICRO_BLOG_BEARER_TOKEN: Your Micro.blog API bearer token. This is required for authentication. Keep it secure and do not expose it in logs or public repositories.

Deployment guidance

• When deploying to a hosting service, configure the MICRO_BLOG_BEARER_TOKEN in the environment settings of your deployment. The server exposes the MCP interface over the transport you choose (HTTP for MCP tools) once deployed.

Recommended usage patterns

• Start by listing your bookshelves, then create a new bookshelf for ongoing reads, add books, and organize them by moving items between shelves as your reading progresses. Regularly check your reading goals and progress to stay on track.

Troubleshooting

• If you cannot connect, verify the bearer token is correct and present in the environment. Ensure the port is not blocked by a firewall. If you see authentication errors, refresh tokens or reissue tokens from Micro.blog as needed.

Usage prompts you can try

Show me all my bookshelves and their contents.

Create a bookshelf named Currently Reading and add Project Hail Mary by Andy Weir to it.

What are my reading goals for this year?

Move book ID 79 to bookshelf ID 23.

Available tools

get_bookshelves

Retrieve all bookshelves associated with your Micro.blog Books account.

get_bookshelf_books

Fetch all books contained within a specified bookshelf.

add_bookshelf

Create a new bookshelf for organizing your books.

rename_bookshelf

Rename an existing bookshelf.

add_book

Add a new book to a specific bookshelf.

move_book

Move a book from one bookshelf to another.”

remove_book

Remove a book from a bookshelf.

change_book_cover

Update the cover image for a book.

get_reading_goals

Retrieve your current reading goals.

get_goal_progress

Get progress toward a specific reading goal.

update_reading_goal

Update a reading goal's target or progress.