Tawaz MCP
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., "@Tawaz MCP Create a research proposal document with an org chart and a bibliography in APA format."
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.
Tawaz DocStudio
The Ultimate Research & Documentation Engine
Transform how you create documents, diagrams, charts, and citations — all from one MCP server.
Tawaz MCP is not just another document generator. It's a full-featured research workflow engine that turns your AI assistant into a documentation powerhouse.
Create Word docs. Build PowerPoint decks. Generate Excel sheets. Draw flowcharts. Render charts. Manage citations. All with a single tool call.
Why Tawaz DocStudio?
Feature | Description |
DOCX | Create & edit Word documents with headings, tables, bullets |
PPTX | Build PowerPoint presentations with styled slides |
XLSX | Generate Excel spreadsheets with multiple sheets |
Diagrams | Flowcharts, org charts, mind maps via Graphviz |
Charts | Bar, line, scatter, pie, heatmap via Matplotlib |
Citations | Parse BibTeX/RIS, generate APA/MLA/IEEE bibliographies |
Search | Global search across all documents in a project |
Structure | Auto-create research project folder layouts |
Related MCP server: Office-Word-MCP-Server
Installation
Prerequisites
Setup
# Clone the repo
git clone https://github.com/Rockstar-1281/tawaz-mcp.git
cd tawaz-mcp
# Install Node.js dependencies
npm install
# Install Python dependencies
py -m pip install graphviz matplotlib bibtexparser pillowWorks Everywhere
Tawaz MCP uses the Model Context Protocol (MCP) — an open standard supported by all major AI coding tools. Works with:
Client | Config Location |
OpenCode |
|
Claude Code |
|
Codex CLI |
|
Cursor |
|
Windsurf |
|
Zed |
|
Cline |
|
Custom Apps | Any MCP client — just point to the server |
OpenCode
{
"mcpServers": {
"tawaz": {
"command": "node",
"args": ["C:\\path\\to\\tawaz-mcp\\index.js"]
}
}
}Claude Code
{
"mcpServers": {
"tawaz": {
"command": "node",
"args": ["C:\\path\\to\\tawaz-mcp\\index.js"]
}
}
}Codex CLI
[mcp_servers.tawaz]
command = "node"
args = ["C:\\path\\to\\tawaz-mcp\\index.js"]Cursor / Windsurf
{
"mcpServers": {
"tawaz": {
"command": "node",
"args": ["C:\\path\\to\\tawaz-mcp\\index.js"]
}
}
}Note: Replace
C:\path\to\tawaz-mcpwith the actual path to your cloned repo.
Available Tools
Document Tools
Tool | What it does |
| Create Word docs with headings, tables, bullets |
| Append, prepend, or replace content in existing DOCX |
| Build PowerPoint presentations |
| Add new slides to existing PPTX |
| Generate Excel spreadsheets |
| Add rows, update cells, manage sheets |
Visual Intelligence
Tool | What it does |
| Generate flowcharts, org charts, mind maps (Graphviz) |
| Create bar, line, scatter, pie, heatmap charts (Matplotlib) |
Citation Management
Tool | What it does |
| Parse BibTeX, RIS, or JSON citation files |
| Generate APA, MLA, Chicago, IEEE bibliographies |
| Format individual in-text citations |
Project Utilities
Tool | What it does |
| Scaffold a research project folder |
| Search across all docs in a folder |
| Get file metadata |
Examples
Create a Flowchart
create_diagram({
type: "flowchart",
output: "./assets/diagrams/methodology",
title: "Research Methodology",
data: "Data Collection -> Analysis -> Validation -> Report"
});Generate a Chart
create_chart({
type: "bar",
output: "./assets/charts/sales",
title: "Q3 Sales",
data: JSON.stringify({ "Widget A": 150, "Widget B": 200, "Widget C": 180 }),
ylabel: "Units Sold"
});Parse BibTeX References
parse_references({
inputPath: "./references.bib",
format: "bibtex"
});Generate APA Bibliography
generate_bibliography({
references: JSON.stringify([
{
key: "smith2023",
type: "article",
fields: {
author: "Smith, John",
title: "AI Research",
year: "2023",
journal: "Nature"
}
}
]),
style: "apa"
});Create a Research Project
create_project_structure({
projectName: "my-research",
basePath: "C:\\Users\\user\\Documents"
});Creates:
my-research/
├── assets/
│ ├── diagrams/
│ ├── charts/
│ └── images/
├── citations/
├── documents/
└── exports/Build a DOCX Report
create_docx({
outputPath: "./report.docx",
title: "Research Report",
content: [
{ type: "heading", text: "1. Introduction", level: 1 },
{ type: "paragraph", text: "This report presents our findings." },
{ type: "heading", text: "2. Methodology", level: 1 },
{ type: "paragraph", text: "See Figure 1 for the process flow." },
{
type: "table",
rows: [
["Metric", "Value"],
["Sample Size", "1000"],
["Confidence", "95%"]
]
}
]
});Supported Formats
Format | Create | Edit |
DOCX | ✅ | ✅ |
PPTX | ✅ | ✅ |
XLSX | ✅ | ✅ |
Visual Intelligence
Diagram Type | Chart Type | Citation Style |
Flowchart | Bar | APA |
Org Chart | Line | MLA |
Mind Map | Scatter | Chicago |
Mermaid | Pie | IEEE |
Heatmap | ||
Grouped |
Contributing
Contributions welcome! Fork the repo, create a feature branch, and submit a PR.
git checkout -b feature/amazing-feature
git commit -m "Add amazing feature"
git push origin feature/amazing-featureLicense
ISC License — see LICENSE for details.
Built with ❤️ by Rockstar-1281
Star ⭐ the repo if you find it useful!
Available Tools
14 toolscreate_chartB
Generate charts (bar, line, scatter, pie, heatmap) from data using Matplotlib
Inputs: data (required), type (required), output (required), title, +2 more.
create_diagramC
Generate diagrams (flowchart, org chart, mind map) using Graphviz
Inputs: data (required), type (required), output (required), title.
create_docxB
Create a Word document (DOCX) with content
Inputs: content (required), outputPath (required), title.
create_pptxA
Create a PowerPoint presentation (PPTX) with slides
Inputs: slides (required), outputPath (required), title.
create_project_structureB
Create a research project folder structure with assets, citations, documents
Inputs: basePath (required), projectName (required).
create_xlsxB
Create an Excel spreadsheet (XLSX) with sheets and data
Inputs: sheets (required), outputPath (required).
edit_docxA
Edit an existing Word document (DOCX) - add content, replace text, or modify
Inputs: inputPath (required), operations (required), outputPath.
edit_pptxB
Edit an existing PowerPoint (PPTX) - add slides, modify content
Inputs: inputPath (required), addSlides, outputPath.
edit_xlsxA
Edit an existing Excel spreadsheet (XLSX) - add rows, update cells, add sheets
Inputs: inputPath (required), operations (required), outputPath.
format_citationB
Format a single citation in the specified style
Inputs: reference (required), style, refNumber.
generate_bibliographyB
Generate a formatted bibliography from parsed references
Inputs: references (required), style, outputPath.
get_file_infoC
Get information about an Office file
Inputs: filePath (required).
parse_referencesB
Parse citation files (BibTeX, RIS, JSON) and extract metadata
Inputs: format (required), inputPath (required).
search_in_folderA
Search for a term across all documents in a folder
Inputs: folderPath (required), searchTerm (required), fileTypes.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools target clearly distinct resource-action pairs, such as create_docx vs edit_docx or create_chart vs create_diagram. The citation-related tools (parse_references, generate_bibliography, format_citation) are related but distinguishable by their focus on parsing, bibliography generation, and single-citation formatting.
Tool names follow a consistent verb_noun snake_case pattern throughout: create_*, edit_*, parse_*, generate_*, search_*, get_*. The few non-create/edit names still use the same predictable style, making the naming convention coherent and easy to navigate.
With 14 tools, the set is well-scoped for a research document and reference management server. Each tool serves a distinct function without unnecessary redundancy or bloat.
The server covers the full create/edit lifecycle for DOCX, PPTX, and XLSX, plus reference parsing and bibliography generation, folder structure creation, search, and visualization. Minor gaps exist, such as no PDF conversion/export or a way to directly insert citations into documents, but most research workflows are reasonably supported.
Maintenance
Related MCP Connectors
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
Create and manage documents, spreadsheets, and presentations from your AI assistant.
Online office suite for AI agents: edit docs, sheets, slides and PDFs in browser or via MCP.
Productivity toolbox for Personal Agents: create PPTs, covers, websites, music and process files.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables complete Office document lifecycle management for AI agents, including creation, editing, conversion, and templating of DOCX, XLSX, PPTX, PDF, and EML files.4089 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to create, read, and manipulate Microsoft Word documents with rich editing capabilities.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, edit, format, and analyze Microsoft Office documents (Excel, Word, PPT, PDF) using natural language, with features like table replication and automated styling.2MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to read, create, edit Word/Excel/PPT files and manage the filesystem on the user's computer via natural language.MIT