Vigil Quest MCP server

Vigil Quest keeps track of long-arc goals. Each quest breaks down into ordered milestones, and each milestone can link to the Vigil Today reminders and vigil.wiki notes that move it forward. The MCP server lets an AI assistant such as Claude or ChatGPT read and edit your quests for you, using the Model Context Protocol.

Connect

Server URL:

https://mcp.vigil.quest/mcp

Add it as a custom connector in Claude or ChatGPT. The server speaks MCP over Streamable HTTP. Local MCP clients work too if their OAuth redirect goes to localhost; the server refuses other redirect addresses.

Sign-in and authorization

You sign in with your vigil.center account, the one account shared across the Vigil apps. The server runs its own OAuth authorization server, using the authorization code flow with PKCE (S256 only). Your client registers itself (dynamic client registration), then sends you to the consent page at vigil.quest/authorize. Sign in there, check the permissions the client asked for, and choose Allow or Deny.

Tokens are opaque random values, and the server stores only their hashes. An access token lasts one hour, a refresh token 90 days. Clients find the endpoints in the standard metadata documents:

https://mcp.vigil.quest/.well-known/oauth-protected-resource
https://mcp.vigil.quest/.well-known/oauth-authorization-server

Scopes

Scope	Allows
`quests:read`	Reading your quests and milestones.
`quests:write`	Creating, changing, archiving and deleting quests and milestones, and linking work.

An assistant only sees the tools that its token's scopes cover.

Tools

The server has 13 tools.

vigil_list_quests quests:read
List your quests, optionally filtered by status (active, done, archived), with milestone progress for each.
vigil_get_quest quests:read
Fetch one quest with all its milestones, linked work and computed progress.
vigil_create_quest quests:write
Create a quest from a title, with an optional "why" and target date.
vigil_update_quest quests:write
Change a quest's title, why, target date or status.
vigil_archive_quest quests:write
Archive a quest. Archived quests drop out of the default list but are kept.
vigil_delete_quest quests:write
Permanently delete a quest and all its milestones. This cannot be undone.
vigil_add_milestone quests:write
Add a milestone to a quest, with an optional due date (up to 100 per quest).
vigil_update_milestone quests:write
Change a milestone's title or due date.
vigil_complete_milestone quests:write
Mark a milestone done, or back to not done.
vigil_reorder_milestone quests:write
Move a milestone to a different position in the quest.
vigil_remove_milestone quests:write
Remove a milestone and its linked work. This cannot be undone.
vigil_link_work quests:write
Attach a Vigil Today reminder, a vigil.wiki note or another quest to a milestone, by its https URL.
vigil_unlink_work quests:write
Remove a linked item from a milestone.

What data the server reads and writes

The tools read and change only the quests in your own Vigil Quest account: titles, the "why", target dates, status, milestones and linked work.
Linking work saves a label, a URL and an optional item id on the milestone. Vigil Quest does not read or change your Vigil Today reminders or vigil.wiki notes.
Every tool call adds an entry to an activity log in your account: the tool name, the granted scopes, success or an error code, the duration, and the arguments, with URLs replaced by a placeholder and any text over 200 characters redacted.
Calls are rate limited per token, at 60 a minute and 600 an hour.

Support

For questions or problems, open a ticket at vigil.center/support and choose vigil.quest as the product.