Reported issues for Outline MCP Server
Pod holds 15 of 15 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.
Back to Outline MCP Server.
Most discussed
Official MCP
Hi 👋 – maintainer of @outline here
We now have an official MCP server built into the application as of https://github.com/outline/outline/releases/tag/v1.6.0 It includes fine-grained document patching and OAuth, so is ideal for most folks.
It would be great if you can include a notice at the top of the README to make folks aware of this – cheers!
Read the thread · 2026-04-13 · closed · external user · 4 comments
Smart Features not working in Claude Desktop
What happened?
I had follow the instructions and couldn't get it working.
Few AI cycles and it implemented a fix locally:
The bug: In vector-store.js, createInitRecord() (line 36-44) creates the table with only 5 fields: id, vector, text, title, url. But the actual sync records (line 96-104 in index.js) include 7 fields — adding documentId and updatedAt. When syncDocuments() first calls getDocumentIds() (line 61) before any real records are inserted, it queries for documentId and upda
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/64) · 2026-02-22 · closed · external user · 2 comments
### Parameter fields marked as required?
I can't tell if I have a genuine bug or not. Or can't figure out how I might make certain. Please excuse my ignorance on the topic of MCP internals.
Are model parameters marked as required? My LLM's were doing pretty good about filling them out in the past but lately they seem to ignore the parameter field and leave it blank despite having all the information to chat back at me. Multiple models, old, new seem to be doing a lot worse. I wondered if maybe the tool descriptions have changed or g
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/153) · 2026-07-25 · open · external user · 1 comment
### Add MCP tool to list out recently documentation changes
### Describe the feature
## Describe the feature
My team is using outline for documentations as well as outline MCP tools, which is great. However, it could be nicer if we have a MCP tool like `list_recent_changes` to update new document changes instead of scrolling manually
## Use case
1. User open AI Agent (Claude Code, Codex)
2. Prompt "What is recent docs change in this week"
3. User get response from AI Agent
I would like to contribute this feature
### Use case
_No response_
### Alte
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/119) · 2026-06-11 · closed · external user · 1 comment
### Ability to disable the AI Features for local instances
Would be good to be able to disable the ai tool via ENV variable.
Local/OS Installations have no AI features (for now), so often the model thinks that it can use the feature and gets errors.
Prompting it to NOT use the tool doesn't work reliably.
Is this an option for you? Or am i missing something?
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/41) · 2025-11-19 · closed · external user · 1 comment
### Sharing vscode continue extension and docker compose configs for tinkerers
Hello, this works well.
Just wanted to share. I got this working under docker compose and then was able to connect to it in vscode using the continue extension. Here's what the two important configurations look like. Hopefully it helps speed things up for someone else.
**Docker Compose**
```yaml
services:
mcp-outline:
# Use the pre-built image or your locally built image
image: ghcr.io/vortiago/mcp-outline:latest # Example image path
ports:
# Maps the container port 3
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/27) · 2025-11-10 · open · external user · 1 comment
### Can I use it in Cursor? How can I configure mcp.json??
Could you provide me the proper way to configure mcp.json to use it in Cursor?
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/10) · 2025-05-04 · closed · external user · 1 comment
### Tracking: prepare for MCP SDK v2 / the 2026-07-28 stateless spec
## Summary
The next MCP spec (dated **2026-07-28**, currently a locked Release Candidate) and the matching **Python SDK v2** introduce changes that affect mcp-outline's transport and session model. This is an umbrella tracking issue — split items into dedicated issues when implementation starts.
**Timeline:** SDK v2 beta ~2026-06-30, stable ~2026-07-27. Spec finalizes 2026-07-28.
## What changes (and why it matters here)
1. **Stateless protocol core** — no `initialize` handshake, no `Mcp-Ses
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/135) · 2026-06-25 · open · 0 comments
## Most recent
### Pin `mcp` to `<2` ahead of the breaking SDK v2 release
## Summary
`pyproject.toml` currently pins `mcp[cli]>=1.20.0` with **no upper bound** (lines 16 and 31). The MCP Python SDK is moving to a **v2** that aligns with the new 2026-07-28 spec (stateless protocol core — no `initialize` handshake, no `Mcp-Session-Id` header). v2 is a **breaking change**, and the SDK maintainers explicitly recommend pinning `<2` until you migrate deliberately.
Timeline (per the python-sdk README): **beta targeted 2026-06-30, stable v2 2026-07-27.** v2 alphas are alrea
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/134) · 2026-06-25 · closed · 0 comments
### support image upload inline text and image modification
### Describe the feature
would be greate if we can use the api to add attachments https://www.getoutline.com/developers#tag/attachments/post/attachmentsdelete
this seams to currently not work
### Use case
_No response_
### Alternatives considered
_No response_
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/115) · 2026-05-20 · open · external user · 0 comments
### Add Attachment fetch support
### Describe the feature
Problem
Documents in Outline can contain attachments (PDFs, images, etc.). The MCP Outline server exposes document text but not attachment content, so agents cannot read or analyze attachments.
Desired behavior
Agents should be able to fetch and use attachment content (e.g., PDFs, images) linked in Outline documents.
Outline API
Outline already supports this via the attachments.redirect endpoint:
Endpoint: POST /api/attachments.redirect
Input: { "id": "<attachment-uui
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/59) · 2026-02-17 · closed · outside contributor · 0 comments
### OUTLINE environment vars not handled correctly: sanitize OUTLINE_API_KEY and normalize OUTLINE_API_URL
Title
OUTLINE environment vars not handled correctly: unexpected whitespace/quotes and missing /api suffix cause auth/endpoint issues
Summary
The application sometimes fails to use `OUTLINE_API_KEY` and `OUTLINE_API_URL` reliably because environment values can include surrounding whitespace or quotes, or the base URL may be supplied without the required `/api` suffix. These formatting issues lead to authentication failures, incorrect API endpoints, and intermittent test/integration failures.
F
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/47) · 2025-11-28 · closed · outside contributor · 0 comments
### Docker healthcheck isn't working
Docker container of mcp-outline shows unhealty.
docker-compose.yml uses healthcheck for mcp-outline service by curl,
but python:3.12-slim-bookworm image for mcp-outline service doesn't contain curl.
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/44) · 2025-11-22 · closed · outside contributor · 0 comments
### Failed to run server: No module named 'mcp_outline'
When ever I try to open Claude, I keep getting this error.
logs
`
2025-05-21T00:50:21.498Z [Document Outline Assistant] [info] Initializing server...
2025-05-21T00:50:21.544Z [Document Outline Assistant] [info] Server started and connected successfully
2025-05-21T00:50:21.546Z [Document Outline Assistant] [info] Message from client: {"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
Fail
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/11) · 2025-05-21 · closed · external user · 0 comments
### Rate-Limit handling
Outline has a quite strict rate-limit policy. Need to add in support for the header and retries.
https://www.getoutline.com/developers#description/rate-limits
[Read the thread](https://github.com/Vortiago/mcp-outline/issues/8) · 2025-04-01 · closed · 0 comments
The remaining reports are on [the project's issue tracker](https://github.com/Vortiago/mcp-outline/issues).