Micro.blog Books MCP Server
This MCP server provides comprehensive management of your Micro.blog books collection through 11 tools:
Bookshelf Management: Retrieve all bookshelves, view books in specific shelves, create new bookshelves, and rename existing ones.
Book Management: Add new books with title, author, and optional ISBN and cover URL; move books between shelves; remove books from shelves; and update book cover images.
Reading Goals: View all reading goals, check progress toward specific goals (including book lists), and update goal targets or current progress.
All operations are authenticated automatically using your Micro.blog bearer token and return JSON responses from the Micro.blog Books API. The server works with Claude Desktop and other MCP clients, and is designed for easy deployment on fastmcp.cloud with simple environment variable setup.
Provides tools for managing Micro.blog book collections, including bookshelf management (creating, renaming, organizing), book operations (adding, moving, removing books), and reading goal tracking and updates through the Micro.blog Books API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Micro.blog Books MCP Server show me all my bookshelves"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Micro.blog Books MCP Server
An MCP (Model Context Protocol) server built with FastMCP that provides access to the Micro.blog Books API. Deployed on Modal and fronted by Cloudflare at https://books.mcp.7robots.org/mcp (a Worker reverse-proxy that rewrites the Host header to the Modal origin robots--micro-mcp-server-web.modal.run). The Cloudflare FQDN is the canonical address; the Modal URL still works directly.
This is a single-user personal server. Because it has write access to your books database, the MCP endpoint is gated by Okta OAuth — the same pattern as the other servers in this fleet. OAuth (rather than a static bearer header) is what lets the server be added as a custom connector on claude.ai, which then syncs to every signed-in Claude client (web, desktop, mobile). Your Micro.blog API token (MICRO_BLOG_BEARER_TOKEN) is separate and stays server-side — it authenticates the server to micro.blog and never reaches MCP clients.
Features
This MCP server provides the following tools for managing your Micro.blog books:
Bookshelf Management
get_bookshelves: Get all your bookshelves
get_bookshelf_books: Get books in a specific bookshelf
add_bookshelf: Create a new bookshelf
rename_bookshelf: Rename an existing bookshelf
Book Management
add_book: Add a new book to a bookshelf
move_book: Move a book between bookshelves
remove_book: Remove a book from a bookshelf
change_book_cover: Update a book's cover image
Reading Goals
get_reading_goals: Get your reading goals
get_goal_progress: Get progress toward a specific reading goal
update_reading_goal: Update a reading goal's target or progress
Related MCP server: apple-books-mcp
Deployment
This server is deployed on Modal.
Prerequisites
A Micro.blog account with API access
A bearer token from your Micro.blog account settings
Environment Variables
Two Modal secrets, kept separate so the micro.blog credential and the OAuth/storage config rotate independently: micro-blog-bearer-token (the API token) and micro-mcp-server-secrets (everything else below).
Variable | Description | Required |
| Your Micro.blog API bearer token (server → micro.blog; stays server-side) | Yes |
| Okta OAuth2 client ID | Yes (for auth) |
| Okta OAuth2 client secret | Yes (for auth) |
| Okta instance domain (e.g. | Yes (for auth) |
| Public Modal URL (no | Yes (for auth) |
| OAuth2 issuer (defaults to | No |
| Fixed key for signing MCP JWTs (auto-generated key is ephemeral across cold starts). Generate with | Production |
| Fernet key encrypting OAuth state in modal.Dict. Generate with | Production |
Auth is opt-in — when OKTA_CLIENT_SECRET is unset, the server runs without authentication (local dev only).
Deploy to Modal
uv sync
# Secret 1 — your micro.blog API token (server -> micro.blog):
uv run modal secret create micro-blog-bearer-token MICRO_BLOG_BEARER_TOKEN=your_microblog_token
# Secret 2 — Okta + storage config (clients -> this server via OAuth):
uv run modal secret create micro-mcp-server-secrets \
OKTA_CLIENT_ID=... OKTA_CLIENT_SECRET=... OKTA_DOMAIN=https://your.okta.com \
MCP_BASE_URL=https://books.mcp.7robots.org \
JWT_SIGNING_KEY="$(python -c 'import secrets; print(secrets.token_urlsafe(32))')" \
STORAGE_ENCRYPTION_KEY="$(python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())')"
# Deploy (clean stale bytecode first — Modal's lazy mounts can serve stale .pyc):
find . -type d -name __pycache__ -exec rm -rf {} +
uv run modal deploy modal_app.pyMCP_BASE_URL is the Cloudflare FQDN https://books.mcp.7robots.org (no /mcp suffix) — the public hostname clients use. The Cloudflare Worker reverse-proxies it to the Modal origin.
Operator checklist (manual steps, outside the agent/code)
These must be done by a human in the Modal/Okta consoles — they are not part of the repo and cannot be scripted from here:
Okta app — in the OAuth application used for this server (this fleet reuses one dev-integrator app):
Add the Sign-in redirect URI
https://books.mcp.7robots.org/auth/callback(the Cloudflare FQDN;/auth/callbackis OIDCProxy's default).On the access policy, confirm Refresh Token is an allowed grant type (required for
offline_access; without it users re-auth ~hourly).Note the client ID, client secret, and domain for the secret.
Generate keys —
JWT_SIGNING_KEYandSTORAGE_ENCRYPTION_KEY(commands above); store in a password manager.Create both Modal secrets (see commands above).
MICRO_BLOG_BEARER_TOKENis your micro.blog token.First deploy, set
MCP_BASE_URLto the Cloudflare FQDNhttps://books.mcp.7robots.org, and redeploy.Verify — connect from Claude (OAuth login), then idle ~5–8 min for scale-to-zero and call a tool again to confirm no re-auth prompt (validates the
modal.Dictpersistence).
Local Development
# Install dependencies
uv sync
# Run the server locally
export MICRO_BLOG_BEARER_TOKEN="your_token_here"
uv run fastmcp run server.py --transport http --port 8000
# Or run directly
uv run python server.pyConnecting a client
The server is OAuth-gated, so add it as a custom connector rather than via a config file:
In claude.ai (or Claude Desktop) → Settings → Connectors → Add custom connector.
Enter the URL:
https://books.mcp.7robots.org/mcpComplete the Okta login when prompted.
Added on claude.ai, the connector is account-level and syncs to every signed-in Claude client (web, desktop, mobile). On first connection you'll be redirected to Okta to authenticate.
Usage
Once connected, you can use the server from Claude Desktop, claude.ai, or any OAuth-capable MCP client.
Example prompts:
"Show me all my bookshelves"
"Add 'Project Hail Mary' by Andy Weir to my Currently Reading bookshelf"
"What are my reading goals for this year?"
"Move book ID 79 to bookshelf ID 23"
API Reference
All tools return JSON responses from the Micro.blog API. The server handles authentication automatically using your bearer token.
For more details about the underlying API, see the Micro.blog Books API documentation.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Available Tools
11 toolsadd_bookB
Add a new book.
Args: title: The title of the book author: The author of the book bookshelf_id: The ID of the bookshelf to add the book to isbn: The ISBN of the book (optional) cover_url: URL to the book cover image (optional)
Inputs: title (required), author (required), bookshelf_id (required), isbn, +1 more. Returns: result
add_bookshelfB
Add a new bookshelf.
Args: name: The name of the new bookshelf
Inputs: name (required). Returns: result
change_book_coverC
Change the cover for a book.
Args: bookshelf_id: The ID of the bookshelf book_id: The ID of the book cover_url: URL to the new cover image
Inputs: bookshelf_id (required), book_id (required), cover_url (required). Returns: result
get_bookshelf_booksB
Get books in a specific bookshelf.
Args: bookshelf_id: The ID of the bookshelf to get books from
Inputs: bookshelf_id (required). Returns: result
get_bookshelvesB
Get all bookshelves from Micro.blog.
Inputs: no named parameters. Returns: result
get_goal_progressC
Get books list progress toward a goal.
Args: goal_id: The ID of the reading goal
Inputs: goal_id (required). Returns: result
get_reading_goalsC
Get reading goals.
Inputs: no named parameters. Returns: result
move_bookB
Move a book to a different bookshelf.
Args: book_id: The ID of the book to move bookshelf_id: The ID of the target bookshelf
Inputs: book_id (required), bookshelf_id (required). Returns: result
remove_bookB
Remove a book from a bookshelf.
Args: bookshelf_id: The ID of the bookshelf book_id: The ID of the book to remove
Inputs: bookshelf_id (required), book_id (required). Returns: result
rename_bookshelfC
Rename a bookshelf.
Args: bookshelf_id: The ID of the bookshelf to rename name: The new name for the bookshelf
Inputs: bookshelf_id (required), name (required). Returns: result
update_reading_goalB
Update reading goal.
Args: goal_id: The ID of the reading goal value: The target number of books for the goal progress: The current progress (number of books read, optional)
Inputs: goal_id (required), value (required), progress. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose with no ambiguity. Tools like add_book, move_book, remove_book, and change_book_cover target specific book operations, while get_bookshelves, rename_bookshelf, and add_bookshelf handle bookshelf management, and get_reading_goals and update_reading_goal focus on goals. The descriptions reinforce these distinct roles, making misselection unlikely.
All tools follow a consistent verb_noun naming pattern throughout, such as add_book, get_bookshelves, rename_bookshelf, and update_reading_goal. There are no deviations in style or convention, making the tool names predictable and easy to understand at a glance.
With 11 tools, the count is well-scoped for managing books, bookshelves, and reading goals. Each tool earns its place by covering essential CRUD operations (e.g., add, get, move, remove, rename, update) without redundancy, fitting neatly within the typical 3-15 tool range for a focused domain.
The tool surface provides complete coverage for the domain of book and bookshelf management. It includes full CRUD for books (add, get, move, remove, change cover) and bookshelves (add, get, rename), plus reading goal operations (get, update). There are no obvious gaps, enabling agents to handle all core workflows without dead ends.
Related MCP Connectors
Official Bookmax MCP server: search and save bookmarks, read notes and docs from AI assistants.
Publish and schedule videos to TikTok, YouTube Shorts, Instagram, Facebook, LinkedIn, Pinterest, Bluesky, Threads and X from Claude, Cursor or any MCP client. Upload once, post everywhere, track views in unified analytics, and retry failed posts. Official platform APIs only, free plan available. Docs: https://docs.multi-upload-tool.com/mcp
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Persistent memory for AI assistants. Save once; recall from Claude, ChatGPT, or any MCP client.
Related MCP Servers
- AlicenseBqualityBmaintenanceConnects BookStack knowledge bases to Claude through 47+ tools covering complete CRUD operations for books, pages, chapters, shelves, users, search, attachments, and permissions. Enables full management of BookStack content and configuration through natural language.56394 npm104MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to read and write local Apple Books library, collections, and annotations. Supports searching, exporting, and modifying books and highlights via MCP tools.1MIT
- AlicenseAqualityBmaintenanceConnects AI assistants to the Hardcover book library, enabling natural language book searches, reading status updates, list management, and library exploration.28237 PyPI10MIT
- AlicenseAqualityDmaintenanceEnables Claude Code and other MCP clients to manage bookmarks, collections, and tags in Raindrop.io accounts via natural language.152MIT